1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.6.7" />
\r
7 <title>i3bar(1)</title>
\r
8 <style type="text/css">
\r
9 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
\r
13 font-family: Georgia,serif;
\r
17 h1, h2, h3, h4, h5, h6,
\r
18 div.title, caption.title,
\r
19 thead, p.table.header,
\r
21 #author, #revnumber, #revdate, #revremark,
\r
23 font-family: Arial,Helvetica,sans-serif;
\r
27 margin: 1em 5% 1em 5%;
\r
32 text-decoration: underline;
\r
48 h1, h2, h3, h4, h5, h6 {
\r
51 margin-bottom: 0.5em;
\r
56 border-bottom: 2px solid silver;
\r
76 border: 1px solid silver;
\r
81 margin-bottom: 0.5em;
\r
87 ul > li { color: #aaa; }
\r
88 ul > li > * { color: black; }
\r
102 #revnumber, #revdate, #revremark {
\r
107 border-top: 2px solid silver;
\r
108 padding-top: 0.5em;
\r
113 padding-bottom: 0.5em;
\r
117 padding-bottom: 0.5em;
\r
122 margin-bottom: 1.5em;
\r
124 div.imageblock, div.exampleblock, div.verseblock,
\r
125 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
126 div.admonitionblock {
\r
128 margin-bottom: 1.5em;
\r
130 div.admonitionblock {
\r
132 margin-bottom: 2.0em;
\r
137 div.content { /* Block element content. */
\r
141 /* Block element titles. */
\r
142 div.title, caption.title {
\r
147 margin-bottom: 0.5em;
\r
153 td div.title:first-child {
\r
156 div.content div.title:first-child {
\r
159 div.content + div.title {
\r
163 div.sidebarblock > div.content {
\r
164 background: #ffffee;
\r
165 border: 1px solid #dddddd;
\r
166 border-left: 4px solid #f0f0f0;
\r
170 div.listingblock > div.content {
\r
171 border: 1px solid #dddddd;
\r
172 border-left: 5px solid #f0f0f0;
\r
173 background: #f8f8f8;
\r
177 div.quoteblock, div.verseblock {
\r
178 padding-left: 1.0em;
\r
179 margin-left: 1.0em;
\r
181 border-left: 5px solid #f0f0f0;
\r
185 div.quoteblock > div.attribution {
\r
186 padding-top: 0.5em;
\r
190 div.verseblock > pre.content {
\r
191 font-family: inherit;
\r
192 font-size: inherit;
\r
194 div.verseblock > div.attribution {
\r
195 padding-top: 0.75em;
\r
198 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
\r
199 div.verseblock + div.attribution {
\r
203 div.admonitionblock .icon {
\r
204 vertical-align: top;
\r
207 text-decoration: underline;
\r
209 padding-right: 0.5em;
\r
211 div.admonitionblock td.content {
\r
212 padding-left: 0.5em;
\r
213 border-left: 3px solid #dddddd;
\r
216 div.exampleblock > div.content {
\r
217 border-left: 3px solid #dddddd;
\r
218 padding-left: 0.5em;
\r
221 div.imageblock div.content { padding-left: 0; }
\r
222 span.image img { border-style: none; }
\r
223 a.image:visited { color: white; }
\r
227 margin-bottom: 0.8em;
\r
232 font-style: normal;
\r
235 dd > *:first-child {
\r
240 list-style-position: outside;
\r
243 list-style-type: decimal;
\r
246 list-style-type: lower-alpha;
\r
249 list-style-type: upper-alpha;
\r
252 list-style-type: lower-roman;
\r
255 list-style-type: upper-roman;
\r
258 div.compact ul, div.compact ol,
\r
259 div.compact p, div.compact p,
\r
260 div.compact div, div.compact div {
\r
262 margin-bottom: 0.1em;
\r
274 margin-bottom: 0.8em;
\r
277 padding-bottom: 15px;
\r
279 dt.hdlist1.strong, td.hdlist1.strong {
\r
283 vertical-align: top;
\r
284 font-style: normal;
\r
285 padding-right: 0.8em;
\r
289 vertical-align: top;
\r
291 div.hdlist.compact tr {
\r
297 background: yellow;
\r
300 .footnote, .footnoteref {
\r
304 span.footnote, span.footnoteref {
\r
305 vertical-align: super;
\r
309 margin: 20px 0 20px 0;
\r
310 padding: 7px 0 0 0;
\r
313 #footnotes div.footnote {
\r
319 border-top: 1px solid silver;
\r
328 padding-right: 0.5em;
\r
329 padding-bottom: 0.3em;
\r
330 vertical-align: top;
\r
332 div.colist td img {
\r
337 #footer-badges { display: none; }
\r
341 margin-bottom: 2.5em;
\r
349 margin-bottom: 0.1em;
\r
352 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
369 span.aqua { color: aqua; }
\r
370 span.black { color: black; }
\r
371 span.blue { color: blue; }
\r
372 span.fuchsia { color: fuchsia; }
\r
373 span.gray { color: gray; }
\r
374 span.green { color: green; }
\r
375 span.lime { color: lime; }
\r
376 span.maroon { color: maroon; }
\r
377 span.navy { color: navy; }
\r
378 span.olive { color: olive; }
\r
379 span.purple { color: purple; }
\r
380 span.red { color: red; }
\r
381 span.silver { color: silver; }
\r
382 span.teal { color: teal; }
\r
383 span.white { color: white; }
\r
384 span.yellow { color: yellow; }
\r
386 span.aqua-background { background: aqua; }
\r
387 span.black-background { background: black; }
\r
388 span.blue-background { background: blue; }
\r
389 span.fuchsia-background { background: fuchsia; }
\r
390 span.gray-background { background: gray; }
\r
391 span.green-background { background: green; }
\r
392 span.lime-background { background: lime; }
\r
393 span.maroon-background { background: maroon; }
\r
394 span.navy-background { background: navy; }
\r
395 span.olive-background { background: olive; }
\r
396 span.purple-background { background: purple; }
\r
397 span.red-background { background: red; }
\r
398 span.silver-background { background: silver; }
\r
399 span.teal-background { background: teal; }
\r
400 span.white-background { background: white; }
\r
401 span.yellow-background { background: yellow; }
\r
403 span.big { font-size: 2em; }
\r
404 span.small { font-size: 0.6em; }
\r
406 span.underline { text-decoration: underline; }
\r
407 span.overline { text-decoration: overline; }
\r
408 span.line-through { text-decoration: line-through; }
\r
410 div.unbreakable { page-break-inside: avoid; }
\r
419 font-family: "Courier New", Courier, monospace;
\r
420 font-size: inherit;
\r
426 margin-bottom: 1.5em;
\r
428 div.tableblock > table {
\r
429 border: 3px solid #527bbd;
\r
431 thead, p.table.header {
\r
438 /* Because the table frame attribute is overriden by CSS in most browsers. */
\r
439 div.tableblock > table[frame="void"] {
\r
440 border-style: none;
\r
442 div.tableblock > table[frame="hsides"] {
\r
443 border-left-style: none;
\r
444 border-right-style: none;
\r
446 div.tableblock > table[frame="vsides"] {
\r
447 border-top-style: none;
\r
448 border-bottom-style: none;
\r
458 font-family: "Courier New", Courier, monospace;
\r
459 font-size: inherit;
\r
465 margin-bottom: 1.5em;
\r
467 thead, p.tableblock.header {
\r
476 border-spacing: 0px;
\r
477 border-style: solid;
\r
478 border-color: #527bbd;
\r
479 border-collapse: collapse;
\r
481 th.tableblock, td.tableblock {
\r
484 border-style: solid;
\r
485 border-color: #527bbd;
\r
488 table.tableblock.frame-topbot {
\r
489 border-left-style: hidden;
\r
490 border-right-style: hidden;
\r
492 table.tableblock.frame-sides {
\r
493 border-top-style: hidden;
\r
494 border-bottom-style: hidden;
\r
496 table.tableblock.frame-none {
\r
497 border-style: hidden;
\r
500 th.tableblock.halign-left, td.tableblock.halign-left {
\r
503 th.tableblock.halign-center, td.tableblock.halign-center {
\r
504 text-align: center;
\r
506 th.tableblock.halign-right, td.tableblock.halign-right {
\r
510 th.tableblock.valign-top, td.tableblock.valign-top {
\r
511 vertical-align: top;
\r
513 th.tableblock.valign-middle, td.tableblock.valign-middle {
\r
514 vertical-align: middle;
\r
516 th.tableblock.valign-bottom, td.tableblock.valign-bottom {
\r
517 vertical-align: bottom;
\r
527 padding-top: 0.5em;
\r
528 padding-bottom: 0.5em;
\r
529 border-top: 2px solid silver;
\r
530 border-bottom: 2px solid silver;
\r
533 border-style: none;
\r
535 body.manpage div.sectionbody {
\r
540 body.manpage div#toc { display: none; }
\r
543 <script type="text/javascript">
\r
545 var asciidoc = { // Namespace.
\r
547 /////////////////////////////////////////////////////////////////////
\r
548 // Table Of Contents generator
\r
549 /////////////////////////////////////////////////////////////////////
\r
551 /* Author: Mihai Bazon, September 2002
\r
552 * http://students.infoiasi.ro/~mishoo
\r
554 * Table Of Content generator
\r
557 * Feel free to use this script under the terms of the GNU General Public
\r
558 * License, as long as you do not remove or alter this notice.
\r
561 /* modified by Troy D. Hanson, September 2006. License: GPL */
\r
562 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
\r
564 // toclevels = 1..4.
\r
565 toc: function (toclevels) {
\r
567 function getText(el) {
\r
569 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
570 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
\r
572 else if (i.firstChild != null)
\r
573 text += getText(i);
\r
578 function TocEntry(el, text, toclevel) {
\r
581 this.toclevel = toclevel;
\r
584 function tocEntries(el, toclevels) {
\r
585 var result = new Array;
\r
586 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
\r
587 // Function that scans the DOM tree for header elements (the DOM2
\r
588 // nodeIterator API would be a better technique but not supported by all
\r
590 var iterate = function (el) {
\r
591 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
592 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
\r
593 var mo = re.exec(i.tagName);
\r
594 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
\r
595 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
\r
605 var toc = document.getElementById("toc");
\r
610 // Delete existing TOC entries in case we're reloading the TOC.
\r
611 var tocEntriesToRemove = [];
\r
613 for (i = 0; i < toc.childNodes.length; i++) {
\r
614 var entry = toc.childNodes[i];
\r
615 if (entry.nodeName.toLowerCase() == 'div'
\r
616 && entry.getAttribute("class")
\r
617 && entry.getAttribute("class").match(/^toclevel/))
\r
618 tocEntriesToRemove.push(entry);
\r
620 for (i = 0; i < tocEntriesToRemove.length; i++) {
\r
621 toc.removeChild(tocEntriesToRemove[i]);
\r
624 // Rebuild TOC entries.
\r
625 var entries = tocEntries(document.getElementById("content"), toclevels);
\r
626 for (var i = 0; i < entries.length; ++i) {
\r
627 var entry = entries[i];
\r
628 if (entry.element.id == "")
\r
629 entry.element.id = "_toc_" + i;
\r
630 var a = document.createElement("a");
\r
631 a.href = "#" + entry.element.id;
\r
632 a.appendChild(document.createTextNode(entry.text));
\r
633 var div = document.createElement("div");
\r
634 div.appendChild(a);
\r
635 div.className = "toclevel" + entry.toclevel;
\r
636 toc.appendChild(div);
\r
638 if (entries.length == 0)
\r
639 toc.parentNode.removeChild(toc);
\r
643 /////////////////////////////////////////////////////////////////////
\r
644 // Footnotes generator
\r
645 /////////////////////////////////////////////////////////////////////
\r
647 /* Based on footnote generation code from:
\r
648 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
\r
651 footnotes: function () {
\r
652 // Delete existing footnote entries in case we're reloading the footnodes.
\r
654 var noteholder = document.getElementById("footnotes");
\r
658 var entriesToRemove = [];
\r
659 for (i = 0; i < noteholder.childNodes.length; i++) {
\r
660 var entry = noteholder.childNodes[i];
\r
661 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
\r
662 entriesToRemove.push(entry);
\r
664 for (i = 0; i < entriesToRemove.length; i++) {
\r
665 noteholder.removeChild(entriesToRemove[i]);
\r
668 // Rebuild footnote entries.
\r
669 var cont = document.getElementById("content");
\r
670 var spans = cont.getElementsByTagName("span");
\r
673 for (i=0; i<spans.length; i++) {
\r
674 if (spans[i].className == "footnote") {
\r
676 var note = spans[i].getAttribute("data-note");
\r
678 // Use [\s\S] in place of . so multi-line matches work.
\r
679 // Because JavaScript has no s (dotall) regex flag.
\r
680 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
\r
681 spans[i].innerHTML =
\r
682 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
\r
683 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
684 spans[i].setAttribute("data-note", note);
\r
686 noteholder.innerHTML +=
\r
687 "<div class='footnote' id='_footnote_" + n + "'>" +
\r
688 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
\r
689 n + "</a>. " + note + "</div>";
\r
690 var id =spans[i].getAttribute("id");
\r
691 if (id != null) refs["#"+id] = n;
\r
695 noteholder.parentNode.removeChild(noteholder);
\r
697 // Process footnoterefs.
\r
698 for (i=0; i<spans.length; i++) {
\r
699 if (spans[i].className == "footnoteref") {
\r
700 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
\r
701 href = href.match(/#.*/)[0]; // Because IE return full URL.
\r
703 spans[i].innerHTML =
\r
704 "[<a href='#_footnote_" + n +
\r
705 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
711 install: function(toclevels) {
\r
714 function reinstall() {
\r
715 asciidoc.footnotes();
\r
717 asciidoc.toc(toclevels);
\r
721 function reinstallAndRemoveTimer() {
\r
722 clearInterval(timerId);
\r
726 timerId = setInterval(reinstall, 500);
\r
727 if (document.addEventListener)
\r
728 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
\r
730 window.onload = reinstallAndRemoveTimer;
\r
734 asciidoc.install();
\r
738 <body class="article">
\r
741 <span id="author">Axel Wagner</span><br />
\r
742 <span id="email"><tt><<a href="mailto:mail+i3bar@merovius.de">mail+i3bar@merovius.de</a>></tt></span><br />
\r
743 <span id="revnumber">version 4.1,</span>
\r
744 <span id="revdate">October 2011</span>
\r
747 <div class="sect1">
\r
748 <h2 id="_name">NAME</h2>
\r
749 <div class="sectionbody">
\r
750 <div class="paragraph"><p>i3bar - xcb-based status- and workspace-bar</p></div>
\r
753 <div class="sect1">
\r
754 <h2 id="_synopsis">SYNOPSIS</h2>
\r
755 <div class="sectionbody">
\r
756 <div class="paragraph"><p><strong>i3bar</strong> [<strong>-s</strong> <em>sock_path</em>] [<strong>-b</strong> <em>bar_id</em>] [<strong>-v</strong>] [<strong>-h</strong>]</p></div>
\r
759 <div class="sect1">
\r
760 <h2 id="_warning">WARNING</h2>
\r
761 <div class="sectionbody">
\r
762 <div class="paragraph"><p>i3bar will automatically be invoked by i3 for every <em>bar</em> configuration block.</p></div>
\r
763 <div class="paragraph"><p>Starting it manually is usually not what you want to do.</p></div>
\r
764 <div class="paragraph"><p>You have been warned!</p></div>
\r
767 <div class="sect1">
\r
768 <h2 id="_options">OPTIONS</h2>
\r
769 <div class="sectionbody">
\r
770 <div class="dlist"><dl>
\r
771 <dt class="hdlist1">
\r
772 <strong>-s, --socket</strong> <em>sock_path</em>
\r
776 Overwrites the path to the i3 IPC socket.
\r
779 <dt class="hdlist1">
\r
780 <strong>-b, --bar_id</strong> <em>bar_id</em>
\r
784 Specifies the bar ID for which to get the configuration from i3.
\r
787 <dt class="hdlist1">
\r
788 <strong>-v, --version</strong>
\r
792 Display version number and exit.
\r
795 <dt class="hdlist1">
\r
796 <strong>-h, --help</strong>
\r
800 Display a short help-message and exit
\r
806 <div class="sect1">
\r
807 <h2 id="_description">DESCRIPTION</h2>
\r
808 <div class="sectionbody">
\r
809 <div class="paragraph"><p><strong>i3bar</strong> displays a bar at the bottom (or top) of your monitor(s) containing
\r
810 workspace switching buttons and a statusline generated by i3status(1) or
\r
811 similar. It is automatically invoked (and configured through) i3.</p></div>
\r
812 <div class="paragraph"><p>i3bar supports colors via a JSON protocol starting from v4.2, see
\r
813 <a href="http://i3wm.org/docs/i3bar-protocol.html">http://i3wm.org/docs/i3bar-protocol.html</a></p></div>
\r
816 <div class="sect1">
\r
817 <h2 id="_environment">ENVIRONMENT</h2>
\r
818 <div class="sectionbody">
\r
819 <div class="sect2">
\r
820 <h3 id="_i3sock">I3SOCK</h3>
\r
821 <div class="paragraph"><p>Used as a fallback for the i3 IPC socket path if neither the commandline
\r
822 contains an argument nor the I3_SOCKET_PATH property is set on the X11 root
\r
827 <div class="sect1">
\r
828 <h2 id="_examples">EXAMPLES</h2>
\r
829 <div class="sectionbody">
\r
830 <div class="paragraph"><p>Nothing to see here, move along. As stated above, you should not run i3bar manually.</p></div>
\r
831 <div class="paragraph"><p>Instead, see the i3 documentation, especially the User’s Guide.</p></div>
\r
834 <div class="sect1">
\r
835 <h2 id="_see_also">SEE ALSO</h2>
\r
836 <div class="sectionbody">
\r
837 <div class="paragraph"><p><tt>i3status(1)</tt>, <tt>j4status(1)</tt> or <tt>conky(1)</tt> for programs generating a statusline.</p></div>
\r
838 <div class="paragraph"><p><tt>dzen2(1)</tt> or <tt>xmobar(1)</tt> for similar programs to i3bar.</p></div>
\r
841 <div class="sect1">
\r
842 <h2 id="_authors">AUTHORS</h2>
\r
843 <div class="sectionbody">
\r
844 <div class="paragraph"><p>Axel Wagner and contributors</p></div>
\r
848 <div id="footnotes"><hr /></div>
\r
850 <div id="footer-text">
\r
852 Last updated 2013-01-26 18:21:10 CET
\r