From: Michael Stapelberg Date: Mon, 16 Jun 2014 20:34:48 +0000 (+0200) Subject: switch from blogofile to jekyll for building the site X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=feed2bf61768ea31a800abb4f8f9e374c2774a11;p=i3%2Fi3.github.io switch from blogofile to jekyll for building the site --- diff --git a/_config.py b/_config.py deleted file mode 100644 index ab60b4c..0000000 --- a/_config.py +++ /dev/null @@ -1,9 +0,0 @@ -blog = controllers.blog -blog.enabled = True -site.url = "http://i3wm.org/" -blog.path = "/blog" -blog.name = "i3 - improved tiling wm - blog" -blog.description = "News about the i3 window manager" -blog.timezone = "Europe/Berlin" -blog.posts_per_page = 5 -blog.disqus.enabled = False diff --git a/_config.yml b/_config.yml new file mode 100644 index 0000000..acba381 --- /dev/null +++ b/_config.yml @@ -0,0 +1,3 @@ +name: i3 +markdown: redcarpet +pygments: true diff --git a/_filters/markdown_template.py b/_filters/markdown_template.py deleted file mode 100644 index c572efa..0000000 --- a/_filters/markdown_template.py +++ /dev/null @@ -1,16 +0,0 @@ -import markdown -import logging - -config = { - 'name': "Markdown", - 'description': "Renders markdown formatted text to HTML", - 'aliases': ['markdown'] - } - - -#Markdown logging is noisy, pot it down: -logging.getLogger("MARKDOWN").setLevel(logging.ERROR) - - -def run(content): - return markdown.markdown(content) diff --git a/_filters/rst_template.py b/_filters/rst_template.py deleted file mode 100644 index 496c36c..0000000 --- a/_filters/rst_template.py +++ /dev/null @@ -1,11 +0,0 @@ -import docutils.core - -config = { - 'name': "reStructuredText", - 'description': "Renders reStructuredText formatted text to HTML", - 'aliases': ['rst'] - } - - -def run(content): - return docutils.core.publish_parts(content, writer_name='html')['html_body'] diff --git a/_filters/syntax_highlight.py b/_filters/syntax_highlight.py deleted file mode 100644 index 2471c43..0000000 --- a/_filters/syntax_highlight.py +++ /dev/null @@ -1,176 +0,0 @@ -import re -import os - -import pygments -from pygments import formatters, util, lexers -import blogofile_bf as bf - -config = {"name": "Syntax Highlighter", - "description": "Highlights blocks of code based on syntax", - "author": "Ryan McGuire", - "css_dir": "/css", - "preload_styles": []} - - -def init(): - #This filter normally only loads pygments styles when needed. - #This will force a particular style to get loaded at startup. - for style in bf.config.filters.syntax_highlight.preload_styles: - css_class = "pygments_{0}".format(style) - formatter = pygments.formatters.HtmlFormatter( - linenos=False, cssclass=css_class, style=style) - write_pygments_css(style, formatter) - - -example = """ - -This is normal text. - -The following is a python code block: - -$$code(lang=python) -import this - -prices = {'apple' : 0.50, #Prices of fruit - 'orange' : 0.65, - 'pear' : 0.90} - -def print_prices(): - for fruit, price in prices.items(): - print "An %s costs %s" % (fruit, price) -$$/code - -This is a ruby code block: - -$$code(lang=ruby) -class Person - attr_reader :name, :age - def initialize(name, age) - @name, @age = name, age - end - def <=>(person) # Comparison operator for sorting - @age <=> person.age - end - def to_s - "#@name (#@age)" - end -end - -group = [ - Person.new("Bob", 33), - Person.new("Chris", 16), - Person.new("Ash", 23) -] - -puts group.sort.reverse -$$/code - -This is normal text -""" - -css_files_written = set() - -code_block_re = re.compile( - r"(?:^|\s)" # $$code Must start as a new word - r"\$\$code" # $$code is the start of the block - r"(?P\([^\r\n]*\))?" # optional arguments are passed in brackets - r"[^\r\n]*\r?\n" # ignore everything else on the 1st line - r"(?P.*?)\s\$\$/code" # code block continues until $$/code - , re.DOTALL) - -argument_re = re.compile( - r"[ ]*" # eat spaces at the beginning - "(?P" # start of argument - ".*?" # the name of the argument - "=" # the assignment - r"""(?:(?:[^"']*?)""" # a non-quoted value - r"""|(?:"[^"]*")""" # or, a double-quoted value - r"""|(?:'[^']*')))""" # or, a single-quoted value - "[ ]*" # eat spaces at the end - "[,\r\n]" # ends in a comma or newline - ) - - -def highlight_code(code, language, formatter): - try: - lexer = pygments.lexers.get_lexer_by_name(language) - except pygments.util.ClassNotFound: - lexer = pygments.lexers.get_lexer_by_name("text") - #Highlight with pygments and surround by blank lines - #(blank lines required for markdown syntax) - highlighted = "\n\n{0}\n\n".format( - pygments.highlight(code, lexer, formatter)) - return highlighted - - -def parse_args(args): - #Make sure the args are newline terminated (req'd by regex) - opts = {} - if args is None: - return opts - args = args.lstrip("(").rstrip(")") - if args[-1] != "\n": - args = args+"\n" - for m in argument_re.finditer(args): - arg = m.group('arg').split('=') - opts[arg[0]] = arg[1] - return opts - - -def write_pygments_css(style, formatter, - location=bf.config.filters.syntax_highlight.css_dir): - path = bf.util.path_join("_site", bf.util.fs_site_path_helper(location)) - bf.util.mkdir(path) - css_file = "pygments_{0}.css".format(style) - css_path = os.path.join(path, css_file) - css_site_path = css_path.replace("_site", "") - if css_site_path in css_files_written: - return #already written, no need to overwrite it. - f = open(css_path, "w") - css_class = ".pygments_{0}".format(style) - f.write(formatter.get_style_defs(css_class)) - f.close() - css_files_written.add(css_site_path) - - -def run(src): - substitutions = {} - for m in code_block_re.finditer(src): - args = parse_args(m.group('args')) - #Make default args - if args.has_key('lang'): - lang = args['lang'] - elif args.has_key('language'): - lang = args['language'] - else: - lang = 'text' - try: - if args.has_key('linenums'): - linenums = args['linenums'] - elif args.has_key("linenos"): - linenums = args['linenos'] - if linenums.lower().strip() == "true": - linenums = True - else: - linenums = False - except: - linenums = False - try: - style = args['style'] - except KeyError: - style = bf.config.filters.syntax_highlight.style - try: - css_class = args['cssclass'] - except KeyError: - css_class = "pygments_{0}".format(style) - formatter = pygments.formatters.HtmlFormatter( - linenos=linenums, cssclass=css_class, style=style) - write_pygments_css(style, formatter) - substitutions[m.group()] = highlight_code( - m.group('code'), lang, formatter) - if len(substitutions) > 0: - p = re.compile('|'.join(map(re.escape, substitutions))) - src = p.sub(lambda x: substitutions[x.group(0)], src) - return src - else: - return src diff --git a/_filters/textile_template.py b/_filters/textile_template.py deleted file mode 100644 index 7863fa2..0000000 --- a/_filters/textile_template.py +++ /dev/null @@ -1,11 +0,0 @@ -import textile - -config = { - 'name': "Textile", - 'description': "Renders textile formatted text to HTML", - 'aliases': ['textile'] - } - - -def run(content): - return textile.textile(content) diff --git a/_includes/downloadlogo.html b/_includes/downloadlogo.html new file mode 100644 index 0000000..fc7d48d --- /dev/null +++ b/_includes/downloadlogo.html @@ -0,0 +1,3 @@ +
+{{include.title}} +
diff --git a/_includes/menulink.html b/_includes/menulink.html new file mode 100644 index 0000000..c5a5ab7 --- /dev/null +++ b/_includes/menulink.html @@ -0,0 +1,5 @@ +{% if page.group == include.name %} +
  • {{include.name}}
  • +{% else %} +
  • {{include.name}}
  • +{% endif %} diff --git a/_includes/screenshot.html b/_includes/screenshot.html new file mode 100644 index 0000000..3fdcffb --- /dev/null +++ b/_includes/screenshot.html @@ -0,0 +1,6 @@ + +
    + (Screenshot) {{include.description}}
    + {{include.description}} +
    + diff --git a/_layouts/default.html b/_layouts/default.html new file mode 100644 index 0000000..68db1dc --- /dev/null +++ b/_layouts/default.html @@ -0,0 +1,79 @@ + + + + + i3 - improved tiling wm + + + + + + +{% if page.javascript != null %} + +{% endif %} + + +
    +

    i3 - improved tiling WM

    + +
    + {{ content }} +
    + + + + diff --git a/_templates/atom.mako b/_templates/atom.mako deleted file mode 100644 index 867e723..0000000 --- a/_templates/atom.mako +++ /dev/null @@ -1,34 +0,0 @@ -<% from datetime import datetime %> - - ${bf.config.blog.name} - ${bf.config.blog.description} - - ${datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%SZ")} - Blogofile - - - ${bf.config.blog.url}/atom.xml - -% for post in posts[:10]: - - - ${post.author} - ${bf.config.blog.url} - - <![CDATA[${post.title}]]> - - ${post.permalink} - ${post.updated.strftime("%Y-%m-%dT%H:%M:%SZ")} - ${post.date.strftime("%Y-%m-%dT%H:%M:%SZ")} -% for category in post.categories: - -% endfor - - - -% endfor - diff --git a/_templates/chronological.mako b/_templates/chronological.mako deleted file mode 100644 index d55162d..0000000 --- a/_templates/chronological.mako +++ /dev/null @@ -1,21 +0,0 @@ -<%! - section = "blog" -%> -<%inherit file="i3.mako" /> - -
    -% for post in posts: - <%include file="post.mako" args="post=post" /> -
    -% endfor -% if prev_link: - « Previous Page -% endif -% if prev_link and next_link: - -- -% endif -% if next_link: - Next Page » -% endif - -
    diff --git a/_templates/i3.mako b/_templates/i3.mako deleted file mode 100644 index a61c234..0000000 --- a/_templates/i3.mako +++ /dev/null @@ -1,94 +0,0 @@ -<%! - require_jquery = False - javascript = None - js_callback = '' -%> - - - - i3 - improved tiling wm - - - - - - -% if self.attr.javascript: - -%endif - - -
    -

    i3 - improved tiling WM

    - -
    - ${next.body()} -
    - - - - diff --git a/_templates/permapage.mako b/_templates/permapage.mako deleted file mode 100644 index 46ccf09..0000000 --- a/_templates/permapage.mako +++ /dev/null @@ -1,7 +0,0 @@ -<%! - section = "blog" -%> -<%inherit file="i3.mako" /> -
    -<%include file="post.mako" args="post=post" /> -
    diff --git a/_templates/post.mako b/_templates/post.mako deleted file mode 100644 index a342294..0000000 --- a/_templates/post.mako +++ /dev/null @@ -1,12 +0,0 @@ -<%page args="post"/> -
    - -

    ${post.date.strftime("%Y-%m-%d")}: ${post.title}

    -
    - ${self.post_prose(post)} -
    -
    - -<%def name="post_prose(post)"> - ${post.content} - diff --git a/_templates/rss.mako b/_templates/rss.mako deleted file mode 100644 index 869d784..0000000 --- a/_templates/rss.mako +++ /dev/null @@ -1,35 +0,0 @@ -<% from datetime import datetime %> - - - ${bf.config.blog.name} - ${bf.config.blog.url} - ${bf.config.blog.description} - ${datetime.utcnow().strftime("%a, %d %b %Y %H:%M:%S GMT")} - Blogofile - hourly - 1 -% for post in posts[:10]: - - ${post.title} - ${post.permalink} - ${post.date.strftime("%a, %d %b %Y %H:%M:%S %Z")} -% for category in post.categories: - -% endfor -% if post.guid: - ${post.guid} -% else: - ${post.permalink} -% endif - ${post.title} - - -% endfor - - diff --git a/contact/index.html b/contact/index.html new file mode 100644 index 0000000..28f21ad --- /dev/null +++ b/contact/index.html @@ -0,0 +1,49 @@ +--- +layout: default +title: Contact +group: Contact +--- +
    +

    Contact

    + +

    +If you have any questions which are not answered by the Documentation, please do not hesitate to contact us. The best +way to reach us is via IRC: +

    + +

    +i3’s IRC channel is +irc://irc.twice-irc.de/i3 (or, #i3 on irc.twice-irc.de, for those without proper URL +handling setup). Feel free to ask questions, please don’t ask to ask and please +think before you ask :-). +

    + +

    Mailing lists

    + +

    +If you dislike IRC, you can also post questions etc. to our mailing list.
    +Subscribe by sending an e-mail to i3-discuss-subscribe@i3.zekjur.net. +You can read old posts in the i3-discuss +archives. +

    + +

    +If you want to be notified when a new version of i3 is released, please +subscribe to the announce mailing list by sending a mail to +i3-announce-subscribe@i3.zekjur.net. You can find the old +announcements in the +i3-announce archives. +

    + +

    Package maintainers

    + +

    +If you are a package maintainer and have any questions, +ideas, hints, problems or whatever, please do not hesitate to contact me. I +will help you out. Just drop me an e-mail at michael AT i3wm DOT org or ask on +our IRC channel (see above). +

    + +
    diff --git a/contact/index.html.mako b/contact/index.html.mako deleted file mode 100644 index faffd09..0000000 --- a/contact/index.html.mako +++ /dev/null @@ -1,48 +0,0 @@ -<%! - section = "contact" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    Contact

    - -

    -If you have any questions which are not answered by the Documentation, please do not hesitate to contact us. The best -way to reach us is via IRC: -

    - -

    -i3’s IRC channel is -irc://irc.twice-irc.de/i3 (or, #i3 on irc.twice-irc.de, for those without proper URL -handling setup). Feel free to ask questions, please don’t ask to ask and please -think before you ask :-). -

    - -

    Mailing lists

    - -

    -If you dislike IRC, you can also post questions etc. to our mailing list.
    -Subscribe by sending an e-mail to i3-discuss-subscribe@i3.zekjur.net. -You can read old posts in the i3-discuss -archives. -

    - -

    -If you want to be notified when a new version of i3 is released, please -subscribe to the announce mailing list by sending a mail to -i3-announce-subscribe@i3.zekjur.net. You can find the old -announcements in the -i3-announce archives. -

    - -

    Package maintainers

    - -

    -If you are a package maintainer and have any questions, -ideas, hints, problems or whatever, please do not hesitate to contact me. I -will help you out. Just drop me an e-mail at michael AT i3wm DOT org or ask on -our IRC channel (see above). -

    - -
    diff --git a/docs/3.e/index.html b/docs/3.e/index.html new file mode 100644 index 0000000..1f2a0ce --- /dev/null +++ b/docs/3.e/index.html @@ -0,0 +1,76 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    Documentation

    + +

    +One of i3’s goals is good documentation. The documents which you will find +below will hopefully answer all your questions. If you have any corrections or +suggestions please let us know! +

    + +

    +These documents are for i3 version 3.ε. Version 4 was released and we strongly recommend you to upgrade! +

    + +
    +

    For users

    + +

    +User’s Guide
    +Introduction and reference. Read this one. +

    + +

    +Multi-monitor
    +Interesting for users of the nVidia driver. +

    + +

    +Debugging i3
    +Explains you how to enable the i3 logfile. +

    + +

    +External workspace bars
    +About bar programs such as i3bar or dzen2. +

    + +

    +i3 reference card (PDF)
    +Might be useful to memorize i3’s shortcuts. +

    +
    + +
    +

    For developers

    + +

    +Downloads → Development version
    +Tells you how to check out our git repository. +

    + +

    +Hacking Howto
    +Helps you if you want to get into i3’s source code. +

    + +

    +Debugging i3
    +Explains you how to enable core dumps. +

    + +

    +IPC documentation
    +Explains how i3’s Inter Process Communication interface works. Read this if you +want to talk to i3 within your own scripts or programs. +

    + +
    + +
    + +
    diff --git a/docs/3.e/index.html.mako b/docs/3.e/index.html.mako deleted file mode 100644 index 59be338..0000000 --- a/docs/3.e/index.html.mako +++ /dev/null @@ -1,75 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    Documentation

    - -

    -One of i3’s goals is good documentation. The documents which you will find -below will hopefully answer all your questions. If you have any corrections or -suggestions please let us know! -

    - -

    -These documents are for i3 version 3.ε. Version 4 was released and we strongly recommend you to upgrade! -

    - -
    -

    For users

    - -

    -User’s Guide
    -Introduction and reference. Read this one. -

    - -

    -Multi-monitor
    -Interesting for users of the nVidia driver. -

    - -

    -Debugging i3
    -Explains you how to enable the i3 logfile. -

    - -

    -External workspace bars
    -About bar programs such as i3bar or dzen2. -

    - -

    -i3 reference card (PDF)
    -Might be useful to memorize i3’s shortcuts. -

    -
    - -
    -

    For developers

    - -

    -Downloads → Development version
    -Tells you how to check out our git repository. -

    - -

    -Hacking Howto
    -Helps you if you want to get into i3’s source code. -

    - -

    -Debugging i3
    -Explains you how to enable core dumps. -

    - -

    -IPC documentation
    -Explains how i3’s Inter Process Communication interface works. Read this if you -want to talk to i3 within your own scripts or programs. -

    - -
    - -
    - -
    diff --git a/docs/4.6/index.html b/docs/4.6/index.html new file mode 100644 index 0000000..36e55d6 --- /dev/null +++ b/docs/4.6/index.html @@ -0,0 +1,119 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    Documentation for i3 v4.7

    + +

    +One of i3’s goals is good documentation. The documents which you will find +below will hopefully answer all your questions. If you have any corrections or +suggestions please let us know! +

    + +
    +

    For users

    + +

    +User’s Guide
    +Introduction and reference. Read this! +

    + +

    +Multi-monitor
    +Interesting for users of the nVidia driver. +

    + +

    +Debugging i3
    +Explains you how to enable debug logging. +

    + +

    +External workspace bars
    +About bar programs such as i3bar or dzen2. +

    + +

    +i3 reference card
    +Might be useful to memorize i3’s shortcuts. +

    +
    + +
    +

    For developers

    + +

    +Hacking Howto
    +Helps you if you want to get into i3’s source code. +

    + +

    +Debugging i3
    +Explains you how to enable debug logging. +

    + +

    +Inter process communication (IPC interface)
    +Read this if you want to talk to i3 within your script. +

    + +

    +i3 testsuite
    +Makes you able to read and write i3 testcases. +

    + +

    +i3bar protocol
    +Documents the JSON based protocol which i3bar uses. +

    + +
    + +
    + +

    User-contributed articles

    + +
    + +

    +i3 buildbot setup (2012-09, by Michael)
    +Describes the buildbot setup i3 uses for +automatic docs, compilation and debian packages. +

    + +

    +Lukáš Zapletal’s i3 +configuration (2012-08, by Lukáš)
    +A detailed explanation of Lukáš’s configuration of i3 and related tools. +

    + +

    +Swapping +workspaces (2012-09, by Sagar)
    +Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs. +

    + +

    +Using conky with +i3bar (2012-11, by Gianrico)
    +Shows how to configure conky to generate JSON input for i3bar (with colors)! +

    + +

    +Enhanced and extensible +i3bar with py3status (2013-02, by Ultrabug)
    +Introduces py3status, a wrapper script for i3status which is easily extensible. +

    + +

    +i3wm T-shirts +(2013-12, by Stefan)
    +Where and how to order official i3 T-shirts. +

    + + +
    + +
    diff --git a/docs/4.6/index.html.mako b/docs/4.6/index.html.mako deleted file mode 100644 index 84d114d..0000000 --- a/docs/4.6/index.html.mako +++ /dev/null @@ -1,118 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    Documentation for i3 v4.7

    - -

    -One of i3’s goals is good documentation. The documents which you will find -below will hopefully answer all your questions. If you have any corrections or -suggestions please let us know! -

    - -
    -

    For users

    - -

    -User’s Guide
    -Introduction and reference. Read this! -

    - -

    -Multi-monitor
    -Interesting for users of the nVidia driver. -

    - -

    -Debugging i3
    -Explains you how to enable debug logging. -

    - -

    -External workspace bars
    -About bar programs such as i3bar or dzen2. -

    - -

    -i3 reference card
    -Might be useful to memorize i3’s shortcuts. -

    -
    - -
    -

    For developers

    - -

    -Hacking Howto
    -Helps you if you want to get into i3’s source code. -

    - -

    -Debugging i3
    -Explains you how to enable debug logging. -

    - -

    -Inter process communication (IPC interface)
    -Read this if you want to talk to i3 within your script. -

    - -

    -i3 testsuite
    -Makes you able to read and write i3 testcases. -

    - -

    -i3bar protocol
    -Documents the JSON based protocol which i3bar uses. -

    - -
    - -
    - -

    User-contributed articles

    - -
    - -

    -i3 buildbot setup (2012-09, by Michael)
    -Describes the buildbot setup i3 uses for -automatic docs, compilation and debian packages. -

    - -

    -Lukáš Zapletal’s i3 -configuration (2012-08, by Lukáš)
    -A detailed explanation of Lukáš’s configuration of i3 and related tools. -

    - -

    -Swapping -workspaces (2012-09, by Sagar)
    -Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs. -

    - -

    -Using conky with -i3bar (2012-11, by Gianrico)
    -Shows how to configure conky to generate JSON input for i3bar (with colors)! -

    - -

    -Enhanced and extensible -i3bar with py3status (2013-02, by Ultrabug)
    -Introduces py3status, a wrapper script for i3status which is easily extensible. -

    - -

    -i3wm T-shirts -(2013-12, by Stefan)
    -Where and how to order official i3 T-shirts. -

    - - -
    - -
    diff --git a/docs/4.7/index.html b/docs/4.7/index.html new file mode 100644 index 0000000..b7050e9 --- /dev/null +++ b/docs/4.7/index.html @@ -0,0 +1,119 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    Documentation for i3 v4.8

    + +

    +One of i3’s goals is good documentation. The documents which you will find +below will hopefully answer all your questions. If you have any corrections or +suggestions please let us know! +

    + +
    +

    For users

    + +

    +User’s Guide
    +Introduction and reference. Read this! +

    + +

    +Multi-monitor
    +Interesting for users of the nVidia driver. +

    + +

    +Debugging i3
    +Explains you how to enable debug logging. +

    + +

    +External workspace bars
    +About bar programs such as i3bar or dzen2. +

    + +

    +i3 reference card
    +Might be useful to memorize i3’s shortcuts. +

    +
    + +
    +

    For developers

    + +

    +Hacking Howto
    +Helps you if you want to get into i3’s source code. +

    + +

    +Debugging i3
    +Explains you how to enable debug logging. +

    + +

    +Inter process communication (IPC interface)
    +Read this if you want to talk to i3 within your script. +

    + +

    +i3 testsuite
    +Makes you able to read and write i3 testcases. +

    + +

    +i3bar protocol
    +Documents the JSON based protocol which i3bar uses. +

    + +
    + +
    + +

    User-contributed articles

    + +
    + +

    +i3 buildbot setup (2012-09, by Michael)
    +Describes the buildbot setup i3 uses for +automatic docs, compilation and debian packages. +

    + +

    +Lukáš Zapletal’s i3 +configuration (2012-08, by Lukáš)
    +A detailed explanation of Lukáš’s configuration of i3 and related tools. +

    + +

    +Swapping +workspaces (2012-09, by Sagar)
    +Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs. +

    + +

    +Using conky with +i3bar (2012-11, by Gianrico)
    +Shows how to configure conky to generate JSON input for i3bar (with colors)! +

    + +

    +Enhanced and extensible +i3bar with py3status (2013-02, by Ultrabug)
    +Introduces py3status, a wrapper script for i3status which is easily extensible. +

    + +

    +i3wm T-shirts +(2013-12, by Stefan)
    +Where and how to order official i3 T-shirts. +

    + + +
    + +
    diff --git a/docs/4.7/index.html.mako b/docs/4.7/index.html.mako deleted file mode 100644 index 59d4a88..0000000 --- a/docs/4.7/index.html.mako +++ /dev/null @@ -1,118 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    Documentation for i3 v4.8

    - -

    -One of i3’s goals is good documentation. The documents which you will find -below will hopefully answer all your questions. If you have any corrections or -suggestions please let us know! -

    - -
    -

    For users

    - -

    -User’s Guide
    -Introduction and reference. Read this! -

    - -

    -Multi-monitor
    -Interesting for users of the nVidia driver. -

    - -

    -Debugging i3
    -Explains you how to enable debug logging. -

    - -

    -External workspace bars
    -About bar programs such as i3bar or dzen2. -

    - -

    -i3 reference card
    -Might be useful to memorize i3’s shortcuts. -

    -
    - -
    -

    For developers

    - -

    -Hacking Howto
    -Helps you if you want to get into i3’s source code. -

    - -

    -Debugging i3
    -Explains you how to enable debug logging. -

    - -

    -Inter process communication (IPC interface)
    -Read this if you want to talk to i3 within your script. -

    - -

    -i3 testsuite
    -Makes you able to read and write i3 testcases. -

    - -

    -i3bar protocol
    -Documents the JSON based protocol which i3bar uses. -

    - -
    - -
    - -

    User-contributed articles

    - -
    - -

    -i3 buildbot setup (2012-09, by Michael)
    -Describes the buildbot setup i3 uses for -automatic docs, compilation and debian packages. -

    - -

    -Lukáš Zapletal’s i3 -configuration (2012-08, by Lukáš)
    -A detailed explanation of Lukáš’s configuration of i3 and related tools. -

    - -

    -Swapping -workspaces (2012-09, by Sagar)
    -Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs. -

    - -

    -Using conky with -i3bar (2012-11, by Gianrico)
    -Shows how to configure conky to generate JSON input for i3bar (with colors)! -

    - -

    -Enhanced and extensible -i3bar with py3status (2013-02, by Ultrabug)
    -Introduces py3status, a wrapper script for i3status which is easily extensible. -

    - -

    -i3wm T-shirts -(2013-12, by Stefan)
    -Where and how to order official i3 T-shirts. -

    - - -
    - -
    diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..6f14e6e --- /dev/null +++ b/docs/index.html @@ -0,0 +1,125 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    Documentation for i3 v4.8

    + +

    +One of i3’s goals is good documentation. The documents which you will find +below will hopefully answer all your questions. If you have any corrections or +suggestions please let us know! +

    + +
    +

    For users

    + +

    +User’s Guide
    +Introduction and reference. Read this! +

    + +

    +Layout saving/restoring
    +Explains how to save a layout and restore it in a new i3 session. +

    + + +

    +Multi-monitor
    +Interesting for users of the nVidia driver. +

    + +

    +Debugging i3
    +Explains you how to enable debug logging. +

    + +

    +External workspace bars
    +About bar programs such as i3bar or dzen2. +

    + +

    +i3 reference card
    +Might be useful to memorize i3’s shortcuts. +

    +
    + +
    +

    For developers

    + +

    +Hacking Howto
    +Helps you if you want to get into i3’s source code. +

    + +

    +Debugging i3
    +Explains you how to enable debug logging. +

    + +

    +Inter process communication (IPC interface)
    +Read this if you want to talk to i3 within your script. +

    + +

    +i3 testsuite
    +Makes you able to read and write i3 testcases. +

    + +

    +i3bar protocol
    +Documents the JSON based protocol which i3bar uses. +

    + +
    + +
    + +

    User-contributed articles

    + +
    + +

    +i3 buildbot setup (2012-09, by Michael)
    +Describes the buildbot setup i3 uses for +automatic docs, compilation and debian packages. +

    + +

    +Lukáš Zapletal’s i3 +configuration (2012-08, by Lukáš)
    +A detailed explanation of Lukáš’s configuration of i3 and related tools. +

    + +

    +Swapping +workspaces (2012-09, by Sagar)
    +Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs. +

    + +

    +Using conky with +i3bar (2012-11, by Gianrico)
    +Shows how to configure conky to generate JSON input for i3bar (with colors)! +

    + +

    +Enhanced and extensible +i3bar with py3status (2013-02, by Ultrabug)
    +Introduces py3status, a wrapper script for i3status which is easily extensible. +

    + +

    +i3wm T-shirts +(2013-12, by Stefan)
    +Where and how to order official i3 T-shirts. +

    + + +
    + +
    diff --git a/docs/index.html.mako b/docs/index.html.mako deleted file mode 100644 index fba865e..0000000 --- a/docs/index.html.mako +++ /dev/null @@ -1,124 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    Documentation for i3 v4.8

    - -

    -One of i3’s goals is good documentation. The documents which you will find -below will hopefully answer all your questions. If you have any corrections or -suggestions please let us know! -

    - -
    -

    For users

    - -

    -User’s Guide
    -Introduction and reference. Read this! -

    - -

    -Layout saving/restoring
    -Explains how to save a layout and restore it in a new i3 session. -

    - - -

    -Multi-monitor
    -Interesting for users of the nVidia driver. -

    - -

    -Debugging i3
    -Explains you how to enable debug logging. -

    - -

    -External workspace bars
    -About bar programs such as i3bar or dzen2. -

    - -

    -i3 reference card
    -Might be useful to memorize i3’s shortcuts. -

    -
    - -
    -

    For developers

    - -

    -Hacking Howto
    -Helps you if you want to get into i3’s source code. -

    - -

    -Debugging i3
    -Explains you how to enable debug logging. -

    - -

    -Inter process communication (IPC interface)
    -Read this if you want to talk to i3 within your script. -

    - -

    -i3 testsuite
    -Makes you able to read and write i3 testcases. -

    - -

    -i3bar protocol
    -Documents the JSON based protocol which i3bar uses. -

    - -
    - -
    - -

    User-contributed articles

    - -
    - -

    -i3 buildbot setup (2012-09, by Michael)
    -Describes the buildbot setup i3 uses for -automatic docs, compilation and debian packages. -

    - -

    -Lukáš Zapletal’s i3 -configuration (2012-08, by Lukáš)
    -A detailed explanation of Lukáš’s configuration of i3 and related tools. -

    - -

    -Swapping -workspaces (2012-09, by Sagar)
    -Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs. -

    - -

    -Using conky with -i3bar (2012-11, by Gianrico)
    -Shows how to configure conky to generate JSON input for i3bar (with colors)! -

    - -

    -Enhanced and extensible -i3bar with py3status (2013-02, by Ultrabug)
    -Introduces py3status, a wrapper script for i3status which is easily extensible. -

    - -

    -i3wm T-shirts -(2013-12, by Stefan)
    -Where and how to order official i3 T-shirts. -

    - - -
    - -
    diff --git a/docs/user-contributed/conky-i3bar.html b/docs/user-contributed/conky-i3bar.html new file mode 100644 index 0000000..fa83156 --- /dev/null +++ b/docs/user-contributed/conky-i3bar.html @@ -0,0 +1,157 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    User-contributed article: Using conky with i3bar

    + +

    +As explained in the i3 documentation, it’s possible to use an +external program to build the status information displayed +by i3bar. +One of those programs is conky, a free, +light-weight system monitor. +

    + +

    +Since conky does not support the i3bar protocol by default, we could use the +plain text output format, but then we cannot have i3bar display colors. This +article shows how to configure conky to have colors with i3bar. +

    + +

    +As explained in more detail in the i3bar protocol description, +i3bar can receive input serialized as JSON, and this way has color support, +among other things (urgency flag, shortening description if more space is needed). +

    + +

    Example of colored status with conky

    + +

    +First of all we have to understand how i3bar expects JSON input: +We have to provide an "infinite array", each element on that array is a "status +line" that is displayed at a certain moment by i3bar. +

    + +

    +Let's make a short example. +We want to build a very simple status that displays the amunt of free space in +home folder and the percentage of used RAM. +Here's a sample JSON text for achieving our goal: +

    + +
    {"version":1}
    +[
    + [].
    +
    + [ { "full_text":"Home 84.0G Free", "color":"#ffffff" },
    +   { "full_text":"RAM 32%" , "color":"#ffffff" } ],
    +
    + [ { "full_text":"Home 84.0G Free", "color":"#ffffff" },
    +   { "full_text":"RAM 34%" , "color":"#ffffff" } ],
    +
    + [....],
    + [....],
    + ...
    + +

    +The first line tells i3bar that we are using JSON input. +The second line is the opening of the "infinite array". +Each line after second is one "instance status" to be displayed in i3bar, +

    + +

    Wrapper script

    + +

    +To obtain this output with conky we have to use it in combination with a short script. +The script will write down the "fixed" part of the output (first and second line), then it will call conky. +It will be conky’s duty to write each of the "instances". +

    + +

    +The script is quite simple: +

    + +
    #!/bin/sh
    +
    +# Send the header so that i3bar knows we want to use JSON:
    +echo '{"version":1}'
    +
    +# Begin the endless array.
    +echo '['
    +
    +# We send an empty first array of blocks to make the loop simpler:
    +echo '[],'
    +
    +# Now send blocks with information forever:
    +exec conky -c $HOME/.conkyrc
    + +

    +Let's save this script as conky-i3bar in $HOME/bin. +In the i3 config file the bar config will be something like that +

    + +
    bar {
    +    status_command $HOME/bin/conky-i3bar
    +}
    + +

    conky configuration

    + +

    +Now we have to write a ~/.conkyrc file in order to obtain the desired status: +

    + +
    [{ "full_text":"Home 84.0G Free" , "color":"#ffffff" },
    + { "full_text":"RAM 32%" , "color":"#ffffff" }],
    + +

    +Here's a sample conkyrc that updates every 2 seconds. Just to make things a litte bit more exciting +we put a condition in the script in order to write the occupied RAM in red if the amount is more than 90%: +

    + +
    out_to_x no
    +own_window no
    +out_to_console yes
    +background no
    +max_text_width 0
    +
    +# Update interval in seconds
    +update_interval 2.0
    +
    +# This is the number of times Conky will update before quitting.
    +# Set to zero to run forever.
    +total_run_times 0
    +
    +# Shortens units to a single character (kiB->k, GiB->G, etc.). Default is off.
    +short_units yes
    +
    +# How strict should if_up be when testing an interface for being up?
    +# The value is one of up, link or address, to check for the interface
    +# being solely up, being up and having link or being up, having link
    +# and an assigned IP address. 
    +if_up_strictness address
    +
    +# Add spaces to keep things from moving about?  This only affects certain objects.
    +# use_spacer should have an argument of left, right, or none
    +use_spacer left
    +
    +# Force UTF8? note that UTF8 support required XFT
    +override_utf8_locale no
    +
    +# number of cpu samples to average
    +# set to 1 to disable averaging
    +cpu_avg_samples 2
    +
    +# Stuff after 'TEXT' will be formatted on screen
    +TEXT
    +
    +# JSON for i3bar
    +{% raw %}
    + [{ "full_text" : "Home ${fs_free /home} Free" , "color" : "\#ffffff" },
    +  { "full_text" : "RAM ${memperc}%" , "color" :
    +    ${if_match ${memperc}<90}"\#ffffff"${else}"\#ff0000"${endif} }],
    +{% endraw %}
    +
    diff --git a/docs/user-contributed/conky-i3bar.html.mako b/docs/user-contributed/conky-i3bar.html.mako deleted file mode 100644 index 7bccc90..0000000 --- a/docs/user-contributed/conky-i3bar.html.mako +++ /dev/null @@ -1,156 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    User-contributed article: Using conky with i3bar

    - -

    -As explained in the i3 documentation, it’s possible to use an -external program to build the status information displayed -by i3bar. -One of those programs is conky, a free, -light-weight system monitor. -

    - -

    -Since conky does not support the i3bar protocol by default, we could use the -plain text output format, but then we cannot have i3bar display colors. This -article shows how to configure conky to have colors with i3bar. -

    - -

    -As explained in more detail in the i3bar protocol description, -i3bar can receive input serialized as JSON, and this way has color support, -among other things (urgency flag, shortening description if more space is needed). -

    - -

    Example of colored status with conky

    - -

    -First of all we have to understand how i3bar expects JSON input: -We have to provide an "infinite array", each element on that array is a "status -line" that is displayed at a certain moment by i3bar. -

    - -

    -Let's make a short example. -We want to build a very simple status that displays the amunt of free space in -home folder and the percentage of used RAM. -Here's a sample JSON text for achieving our goal: -

    - -
    {"version":1}
    -[
    - [].
    -
    - [ { "full_text":"Home 84.0G Free", "color":"#ffffff" },
    -   { "full_text":"RAM 32%" , "color":"#ffffff" } ],
    -
    - [ { "full_text":"Home 84.0G Free", "color":"#ffffff" },
    -   { "full_text":"RAM 34%" , "color":"#ffffff" } ],
    -
    - [....],
    - [....],
    - ...
    - -

    -The first line tells i3bar that we are using JSON input. -The second line is the opening of the "infinite array". -Each line after second is one "instance status" to be displayed in i3bar, -

    - -

    Wrapper script

    - -

    -To obtain this output with conky we have to use it in combination with a short script. -The script will write down the "fixed" part of the output (first and second line), then it will call conky. -It will be conky’s duty to write each of the "instances". -

    - -

    -The script is quite simple: -

    - -
    #!/bin/sh
    -
    -# Send the header so that i3bar knows we want to use JSON:
    -echo '{"version":1}'
    -
    -# Begin the endless array.
    -echo '['
    -
    -# We send an empty first array of blocks to make the loop simpler:
    -echo '[],'
    -
    -# Now send blocks with information forever:
    -exec conky -c $HOME/.conkyrc
    - -

    -Let's save this script as conky-i3bar in $HOME/bin. -In the i3 config file the bar config will be something like that -

    - -
    bar {
    -    status_command $HOME/bin/conky-i3bar
    -}
    - -

    conky configuration

    - -

    -Now we have to write a ~/.conkyrc file in order to obtain the desired status: -

    - -
    [{ "full_text":"Home 84.0G Free" , "color":"#ffffff" },
    - { "full_text":"RAM 32%" , "color":"#ffffff" }],
    - -

    -Here's a sample conkyrc that updates every 2 seconds. Just to make things a litte bit more exciting -we put a condition in the script in order to write the occupied RAM in red if the amount is more than 90%: -

    - -
    out_to_x no
    -own_window no
    -out_to_console yes
    -background no
    -max_text_width 0
    -
    -# Update interval in seconds
    -update_interval 2.0
    -
    -# This is the number of times Conky will update before quitting.
    -# Set to zero to run forever.
    -total_run_times 0
    -
    -# Shortens units to a single character (kiB->k, GiB->G, etc.). Default is off.
    -short_units yes
    -
    -# How strict should if_up be when testing an interface for being up?
    -# The value is one of up, link or address, to check for the interface
    -# being solely up, being up and having link or being up, having link
    -# and an assigned IP address. 
    -if_up_strictness address
    -
    -# Add spaces to keep things from moving about?  This only affects certain objects.
    -# use_spacer should have an argument of left, right, or none
    -use_spacer left
    -
    -# Force UTF8? note that UTF8 support required XFT
    -override_utf8_locale no
    -
    -# number of cpu samples to average
    -# set to 1 to disable averaging
    -cpu_avg_samples 2
    -
    -# Stuff after 'TEXT' will be formatted on screen
    -TEXT
    -
    -# JSON for i3bar
    -<%text filter="h">
    - [{ "full_text" : "Home ${fs_free /home} Free" , "color" : "\#ffffff" },
    -  { "full_text" : "RAM ${memperc}%" , "color" :
    -    ${if_match ${memperc}<90}"\#ffffff"${else}"\#ff0000"${endif} }],
    -
    -
    diff --git a/docs/user-contributed/lzap-config.html b/docs/user-contributed/lzap-config.html new file mode 100644 index 0000000..6d7ddf6 --- /dev/null +++ b/docs/user-contributed/lzap-config.html @@ -0,0 +1,474 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    User-contributed article: Lukáš Zapletal’s i3 configuration

    + +

    I was keeping sight on i3 for some time after I saw Michael’s presentation at Google the other day. Last weekend, I upgraded my Fedora 17 and when I noticed i3 version 4.2 in the repositories, I gave it a try. First of all, I have to admit I’ve fallen in love. Totally.

    + +

    It’s a tiling window manager which is lightweight yet powerful. What I like about i3 is ease of adopting it. Michael, the main author of this awesome software, made the default configuration very sane. And i3 is also very fast by it’s (UNIX) design. Last but not least, i3 saves every pixel on the screen. You can get the most from your screen(s). And yes - it does support multiple screens very nicely.

    + +

    Instead of describing how it looks like when you use i3, I’d rather publish my (pretty new) configuration describing each line of it. Before I start, I need to highlight one thing. It’s a tiling window manager. You manage windows into tiles, it’s the basic idea. While you can turn windows into “normal” (the correct term is “floating”) mode, you loose lots of things and this is not the mode you want to work in. It is mainly used by i3 for dialogs, tooltips or other temporary windows.

    + +

    Installation

    + +

    Is pretty straightforward. We need i3 itself and several other highly recommended apps I will describe later. In short: simple screen locker, starter menu and simple notification daemon.

    + +
    # yum -y install i3 i3lock dmenu dunst
    + +

    Please note dunst is not in Fedora 17 repositories, but I have created a review request. Feel free to take it for review.

    + +

    Exit your desktop environment or window manager and log on into i3 from the GDM menu (if you use it). i3 will ask to create initial configuration during the first start. Say yes and do not worry - reloading/restarting i3 is fluent and you can do this zillions of times without loosing a single window.

    + +

    i3 configuration

    + +

    Configuration is located in .i3/config. Let’s do the walkthrough.

    + +
    set $mod Mod4
    + +

    i3 works best with a modifier key set to ALT (Mod1) or WIN (Mod4). I have a windows key on my keyboard unused anyway, so I use it as my main modifier key (with few exceptions bellow).

    + +
    # font for window titles. ISO 10646 = Unicode
    +font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
    + +

    Basic font for windows titles. I was experimenting with my favourite one - Terminus - but the default (misc-fixed) works great and is narrower.

    + +
    # Use Mouse+$mod to drag floating windows to their wanted position
    +floating_modifier $mod
    + +

    By default windows has 1 pixel border, so it’s difficult to resize them with mouse. With this option, you can move windows with modifier + left click and resize with modifier + right click. I bet Apple patented this already, but who cares.

    + +
    # start a terminal
    +bindsym $mod+Return exec i3-sensible-terminal
    + +

    I am starting terminals a lot. Like fifty a day, or even more. Michael’s default configuration has this binding and I keep it. By the way i3 has several i3-* scripts (three I guess) which tries to find “the best” terminal (editor etc). In my case its urxvt and vim, but i3-* will find out from ENV variables of course.

    + +
    # kill focused window
    +bindsym $mod+Shift+Q kill
    + +

    As you will notice shortly, i3 does not draw any minimize, maximize and close buttons. Except the latter, they are useless. It turns out every single application has an exit path (usually using Ctrl+q or something like that), so you don’t need the [X] button. Few apps do not support it (like very old xev), you can use this shortcut that tries to close it nicely first and it kills it if it does not work.

    + +
    # start dmenu (a program launcher)
    +bindsym $mod+d exec dmenu_run
    + +

    Do you think there is a start menu or icons on a desktop in i3? Well, it’s a window manager. Of course not. By default it uses excellent dmenu starter and this simple wrapper that ships with it. Basically, it makes a cache of all executable applications and shows them while you type in a top bar. It’s fast. It’s awesome.

    + +
    # reload/restart/exit
    +bindsym $mod+Shift+C reload
    +bindsym $mod+Shift+R restart
    +bindsym $mod+Shift+E exit
    + +

    Few default key bindings you will like when playing with configuration.

    + +
    # screen locker (first move to "safe" workspace without any chat app)
    +bindsym Control+Mod1+l exec i3-msg workspace 1 && i3lock -c 111111 -d
    + +

    My invention here. Locking a screen is an easy task, but unlocking it without providing your password to other team folks via IRC channel is a challenge (for a guy in the Pulp team ;-) therefore I switch to the first workspace first where is not my IRC chat. Ever. I have to admit the issue is more when you don’t have your screen lock, but it was fun to create this key.

    + +

    Please note i3lock built into Fedora 17 does NOT support loading of images. The software itself is capable of loading images instead of solid color, but this feature was not built. Just stick with a solid color for now.

    + +

    By the way, you just saw i3-msg command which is distributed with i3 distribution. Every single command you see here in the bindsym and exec statements can be sent to i3 using i3-msg. You can create shell scripts with starting up applications, moving them around, changing workspaces and I can’t possibly imagine what can you do with it. Everything.

    + +
    # change focus
    +bindsym $mod+j focus left
    +bindsym $mod+k focus down
    +bindsym $mod+l focus up
    +bindsym $mod+semicolon focus right
    +#bindsym $mod+uring focus right
    + +

    Default configuration for moving around. Notice this is not exactly what we know from Vim (its HJKL there). I thought I will hate it, but I got used to it in two hours. The commented line is for Czech keyboard layout (there is u with ring instead of semicolon) - ignore it if you don’t use this one.

    + +
    # alternatively, you can use the cursor keys:
    +bindsym $mod+Left focus left
    +bindsym $mod+Down focus down
    +bindsym $mod+Up focus up
    +bindsym $mod+Right focus right
    + +

    I sometimes use arrow keys, usually when I don’t have my hands in the working position. It is likely when I eat :-)

    + +
    # move focused window
    +bindsym $mod+Shift+J move left
    +bindsym $mod+Shift+K move down
    +bindsym $mod+Shift+L move up
    +bindsym $mod+Shift+colon move right
    + +

    Moving windows around is so simple with tiling managers. Just hold shift and you drag the window there.

    + +
    # alternatively, you can use the cursor keys:
    +bindsym $mod+Shift+Left move left
    +bindsym $mod+Shift+Down move down
    +bindsym $mod+Shift+Up move up
    +bindsym $mod+Shift+Right move right
    + +

    I don’t use this with arrow keys, but it’s defined by default. Why not.

    + +
    # split in horizontal orientation
    +bindsym $mod+h split h
    +
    +# split in vertical orientation
    +bindsym $mod+v split v
    + +

    This is important. By default i3 splits the screen according to the screen size. For wide screens it’s usually horizontal split. You can configure this behavior if you want, but sometimes you want to split different way. That is what these bindings are for. i3 remembers that for the workspace, so you can split multiple windows easily.

    + +
    # enter fullscreen mode for the focused container
    +bindsym $mod+f fullscreen
    + +

    Fullscreen is something you don’t use many times with standard window managers, but in tiling mode it is pretty useful. I use it a lot when I wan’t to “zoom in” a window.

    + +
    # change container layout (stacked, tabbed, default)
    +bindsym $mod+s layout stacking
    +bindsym $mod+w layout tabbed
    +bindsym $mod+e layout default
    + +

    Unique feature of i3, I would say. Best thing what you can do is to see a picture. You can switch from tiling (default) to tabbed and stacking mode. You can have multiple Firefox instances in windows tabs if you want to. By the way, the i3 User’s Guide is the definitive document you want to read twice.

    + +
    # toggle tiling / floating
    +bindsym $mod+Shift+space floating toggle
    + +

    Some applications does not work well in the tiling mode, because all windows are maximalized by default and according to your screen size and number of other containers there first application can be quite stretched. If your application looks weird, you can always switch to the floating (“normal”) mode, and back and forth with this key mapping. By default, i3 recognizes dialogs and tool windows, so you do not to switch all windows. Actually I had to switch only one application by now.

    + +
    # change focus between tiling / floating windows
    +bindsym $mod+space focus mode_toggle
    + +

    If you have multiple windows in tiling and floating mode, you want to switch between those two groups. You do it with this key.

    + +
    # focus the parent container
    +#bindsym $mod+a focus parent
    +
    +# focus the child container
    +#bindcode $mod+d focus child
    + +

    I have to admit I never used this, because I try to keep number of windows on each workspace low (up to 6 I would say). It moves focus to parent or child window, perhaps more usable with more windows. Share your experiences with this. Notice it’s disabled because I use mod+d for the dmenu.

    + +
    # next/previous workspace
    +bindsym Mod1+Tab focus right
    +bindsym Mod1+Shift+Tab focus left
    +bindsym $mod+Tab workspace back_and_forth
    + +

    This is not standard binding, but I find Alt+Tab pretty useful combination. It’s handy (I use my right hand for mouse) and it was not used by i3. So I started using it for cycling through windows on one workspace. If you have various (horizontal and vertical splits), it does not cycle through all of them. It’s only moving in vertical movement (right - left). I wish there has been a option like “focus cycle” in the next i3 version.

    + +

    Shift does the other way around while Win+Tab switches to the last used weapon. Sorry, I said weapon? I mean workspace.

    + +
    # switch to workspace
    +bindsym $mod+ampersand workspace 1
    +bindsym $mod+eacute workspace 2
    +bindsym $mod+quotedbl workspace 3
    +bindsym $mod+apostrophe workspace 4
    +bindsym $mod+parenleft workspace 5
    +bindsym $mod+minus workspace 6
    +bindsym $mod+egrave workspace 7
    +bindsym $mod+underscore workspace 8
    +bindsym $mod+ccedilla workspace 9
    +bindsym $mod+agrave workspace 10
    +#bindsym $mod+1 workspace 1
    +#bindsym $mod+2 workspace 2
    +#bindsym $mod+3 workspace 3
    +#bindsym $mod+4 workspace 4
    +#bindsym $mod+5 workspace 5
    +#bindsym $mod+6 workspace 6
    +#bindsym $mod+7 workspace 7
    +#bindsym $mod+8 workspace 8
    +#bindsym $mod+9 workspace 9
    +#bindsym $mod+0 workspace 10
    +
    +# switch to workspace (f1-f4)
    +bindsym F1 workspace 1
    +bindsym F2 workspace 2
    +bindsym F3 workspace 3
    +bindsym F4 workspace 4
    +bindsym Mod1+F1 workspace 5
    +bindsym Mod1+F2 workspace 6
    +bindsym Mod1+F3 workspace 7
    +bindsym Mod1+F4 workspace 8
    + +

    Okay, the first block is default binding. But for many years I decided to leverage F1-F4 keys for workspace movement. Until now, I was using only four workspaces (OpenBox, KDE/GNOME, Fluxbox and XFce), but with i3 and its good support of multiple screens I can afford eight now. Each screen has four independent workspaces.

    + +

    Please note the commented part is for Czech layout, therefore if you use this layout uncomment it and delete the above.

    + +

    Now let me explain function keys a bit. First of all I realized many years ago that no one (including me) ever use F1 key. It’s reserved, it’s for help. But everybody is googling these days instead searching through built-in docs. The same for F2, F3 and F4. Maybe some IDEs offer some important stuff, but I use Vim that has no function keys binding. That is the reason why I gave up with those keys and use them for workspace switching.

    + +

    With i3 I have decided also to map Alt+F1-F4 for accessing numbers five to eight. It just seem natural for me now. I am giving up with Alt-F2 (Run App in GNOME) or Alt-F4 (Close App), but this does no work in i3 anymore. Few apps still react on Alt-F4, but there is a different combination available for that.

    + +

    If you occasionally need those keys, you can create a re-mapping that would trigger them with Win+F1-F4 keys. But in terminals you can always use ESC combination (ESC;1 for F1). I don’t use any X11 application that needs that.

    + +

    Therefore workspaces 1-4 are on the laptop screen (LDVS1) and 5-8 are on the main monitor (HDMI1). And there is one workspace hidden called scratch one. More about it later.

    + +
    # move focused container to workspace
    +bindsym $mod+Shift+1 move container to workspace 1
    +bindsym $mod+Shift+2 move container to workspace 2
    +bindsym $mod+Shift+3 move container to workspace 3
    +bindsym $mod+Shift+4 move container to workspace 4
    +bindsym $mod+Shift+5 move container to workspace 5
    +bindsym $mod+Shift+6 move container to workspace 6
    +bindsym $mod+Shift+7 move container to workspace 7
    +bindsym $mod+Shift+8 move container to workspace 8
    +bindsym $mod+Shift+9 move container to workspace 9
    +bindsym $mod+Shift+0 move container to workspace 10
    + +

    Default setting for transferring windows (containers) among workspaces. Those works for both Czech and English layout and are installed by default.

    + +
    # border changing
    +bindsym $mod+b border toggle
    + +

    I cycle through normal, 1pixel and none values with this keybinding. By default it’s bound to mod+t, mod+y and mod+u.

    + +
    # scratchpad
    +bindsym $mod+m move scratchpad
    +bindsym $mod+o scratchpad show
    + +

    Now THIS is cool. There is one hidden workspace that is nowhere and everywhere. It’s empty by default, thus invisible. You can move there any window you want with mod+m. Container is switched over to floating mode and it’s centered on the screen giving it some decent size. Than you can quickly show this window with mod+o key. If you hit it twice, it disappears.

    + +

    This is cool feature, I like to have an extra terminal there for quick looks while I am working. Maybe you want your favourite e-mail application there. Or something other you want to keep hiddennhandy.

    + +

    Please note floating applications always stays on top of tiled containers. So scratchpad is not intended for long tasks. It’s better for short tasks you need to do many times a day. Oh, you can open scratchpad on top of any workspace you want. This is also great for copy and paste.

    + +
    # resize window (you can also use the mouse for that)
    +mode "resize" {
    +  # These bindings trigger as soon as you enter the resize mode
    +  bindsym j resize shrink width 10 px or 10 ppt
    +  bindsym k resize grow height 10 px or 10 ppt
    +  bindsym l resize shrink height 10 px or 10 ppt
    +  bindsym semicolon resize grow width 10 px or 10 ppt
    +  #bindsym uring resize grow width 10 px or 10 ppt
    +
    +  # same bindings, but for the arrow keys
    +  bindsym 113 resize shrink width 10 px or 10 ppt
    +  bindsym 116 resize grow height 10 px or 10 ppt
    +  bindsym 111 resize shrink height 10 px or 10 ppt
    +  bindsym 114 resize grow width 10 px or 10 ppt
    +
    +  # back to normal: Enter or Escape
    +  bindsym Return mode "default"
    +  bindsym Escape mode "default"
    +}
    +
    +bindsym $mod+r mode "resize"
    + +

    I like to resize windows with mouse, but with keys it’s more fun and also much faster. I need to get used to it. You enter resize mode with mod+r combination, then usint JKL and semicolon (note uring for my Czech layout) you change the window size. And than you must switch back to the normal mode with ESC or ENTER key. Standard key bindings are not available in the resize mode and you will notice why nothing is working. Remember, you need to return.

    + +

    I bet you can create your own modes like “work” and “fun” with totally different key bindings. Never tried this.

    + +
    # pulse audio volume control
    +bindsym XF86AudioLowerVolume exec /usr/bin/pactl set-sink-volume 0 -- '-5%'
    +bindsym XF86AudioRaiseVolume exec /usr/bin/pactl set-sink-volume 0 -- '+5%'
    +bindsym XF86AudioMute exec /usr/bin/pactl set-sink-volume 0 0
    +bindsym XF86Launch1 exec /usr/bin/pactl play-sample that_was_easy
    +bindsym XF86MonBrightnessUp exec /usr/bin/xbacklight -inc 10
    +bindsym XF86MonBrightnessDown exec /usr/bin/xbacklight -dec 5
    + +

    Few ThinkPad laptop key bindings for controlling volume, brightness and ThinkVantage for playing That Was Easy (TM) sample just for fun. I don’t use laptop keyboard much.

    + +
    # $mod+n reserved for close all notifications
    +# see ~/.config/dunst/dunstrc for more
    + +

    Just a note for myself not to override mod+n which is used by dunst. More about it later.

    + +
    # one bar on both screens
    +bar {
    +  position top
    +  mode hide
    +  modifier $mod
    +  status_command i3status
    +  tray_output LVDS1
    +}
    + +

    i3 uses i3bar application to draw a very minimalistic bar that can be positioned on the top or bottom of the screen (all screens by default). I like having my bar on top. Content of the bar is delivered with an external program using IPC - i3status in my case. More about its configuration later.

    + +

    Only one bar can contain tray area - laptop screen in my case. The bar is very thin, tray icons are also small. I like it. The “mode hide” statement hides the bar and opens it once I hit “modifier” key, or on a workspace highlight. By the way when the bar is hidden, i3 also notifies the i3status program so it’s not feeding with data to save CPU time and thus battery.

    + +

    By default i3bar shows workspaces and you can switch them with a mouse. It’s good not to disable this (even if you don’t use mouse for that) just to have a nice overview about all workspaces which are kind a dynamic (like in GNOME 3), they appear once you move there for the first time and disappear when you leave it (and there is no other container on it). Therefore you can work with them like in GNOME 3 if you want. I have my numbers 9 and 10 ready for that.

    + +
    # workspace screens
    +workspace 1 output HDMI1
    +workspace 2 output HDMI1
    +workspace 3 output HDMI1
    +workspace 4 output HDMI1
    +workspace 5 output LVDS1
    +workspace 6 output LVDS1
    +workspace 7 output LVDS1
    +workspace 8 output LVDS1
    + +

    i3 works very well with multiple monitors. The default behavior is where you create a workspace it stays there forever, or until you disconnect the screen respectively. Therefore it’s up to you where you create your workspaces.

    + +

    I like to have an order in this, workspaces 1-4 are on the main screen, 5-8 are on the laptop. Therefore I explicitly say this in my configuration. By the way you can easily move workspaces across screens, but I don’t use any key bindings for that.

    + +

    When you disconnect your laptop from dock, everything stays “as is” until xrandr notice the screen is off. This is not by default and I like this behavior (depends on your distribution). You can switch off the screen using xranrd command, but sometimes I prefer to attend a meeting or something and then returning without any change (having workspaces on the main screen invisible for a while). I like to have an option in this case. Of course once i3 determines screen has been turned off using xrandr, it moves all workspaces to the remaining screen.

    + +

    You can also do this manually with i3-msg workspace N output OUTPUT therefore I created two bash scripts dock and undock that transfers all my workspaces in/out of LDVDS1. This is awesome, I really love this feature. I have never seen a window manager that plays THAT nicely with multiple screens.

    + +
    # workspace assignment (use "xprop")
    +assign [class="^Google-chrome$"] 3
    +assign [class="^URxvt$" instance="^mail$"] 4
    +assign [class="^Xchat$"] 5
    +assign [class="^Rednotebook$"] 6
    +assign [class="^Decibel-audio-player.py$"] 7
    +assign [title="Lingea Lexicon 5$"] 8
    +
    +# custom window settings
    +for_window [class="^URxvt$" instance="scratchpad"] border 1pixel; move scratchpad
    +for_window [class="^Google-chrome$"] border none
    +for_window [title="Lingea Lexicon 5$"] border none
    +
    +# get elluminate working
    +for_window [title="^Elluminate Live!"] floating enable
    +for_window [title="^Application Sharing"] floating enable
    +for_window [class="^net-sourceforge-jnlp-runtime-Boot$" title="^Downloading"] floating enable
    + +

    In this block, I force some applications to start on specific screens. You can see apps that I use everyday. IRC chat, notebook, audio player, dictionary, browser and that’s it.

    + +

    Than if I start a terminal with the name of “scratchpad” it changes its border to 1pixel and moves to the background – scratchpad, remember? This is cool.

    + +

    And I need to use Elluminate application for desktop sharing and meetings. It’s a Java application that does not look nice in the tiled mode, therefore I force it into floating mode. Good news is it is working actually, if you use it with Sun JRE. There are not many window managers Elluminate is working in, seriously.

    + +
    # before autostart
    +exec --no-startup-id pactl upload-sample ~/.i3/that_was_easy.wav that_was_easy
    +exec urxvt -name scratchpad -e bash
    +exec ~/.i3/autostart
    +
    +# autostart
    +exec google-chrome
    +exec urxvt -name mail -e bash -c "mutt"
    +exec xchat
    +exec rednotebook
    +exec decibel-audio-player
    +exec lexicon
    + +

    The last block is just auto starting some applications during startup. I load the funny sample, open a scratchpad terminal (which goes to the background automatically) and then I start a shell script with additional commands. I could put this into .xinitrc, but I keep it here. And then some applications.

    + +

    When I start my laptop, I get the same. Everyday. Cool, isn’t it?

    + +

    Autostart

    + +

    My autostart script triggers some settings and spawns some daemons. It’s totally optional in i3, you could do everything using “exec” commands, but I leveraged my old xinitrc script for that. Let’s do the showcase again.

    + +
    #!/bin/sh
    +
    +## Desktop background color
    +xsetroot -solid '#101010' &
    + +

    Again, i3 is a window manager, not a desktop environment. I don’t like “wallpapers, I just set a decent color here.

    + +
    ## Set startup volume
    +pactl set-sink-volume 0 '20%' &
    + +

    I hate random volume after start. Can cause injuries with my speakers. Every time I start my laptop, volume is set to 20 per cent.

    + +
    ## Disable beeps
    +xset -b &
    + +

    Don’t like PC-speaker beeping at all.

    + +
    ## Keybord layout setting
    +setxkbmap -layout cz,us -option grp:shift_shift_toggle &
    + +

    I told you – Czech layout.

    + +
    ## DPMS monitor setting (standby -> suspend -> off) (seconds)
    +xset dpms 300 600 900 &
    + +

    I do not use screen “savers”, blank it after 5 minutes, suspend and then go off after 5+5 minutes. THIS is screen saving.

    + +
    ## Set LCD brightness
    +xbacklight -set 90 &
    + +

    The same story as with volume, backlight set to 90 % after start.

    + +
    ## Clipboard manager
    +LC_ALL=C parcellite &
    + +

    Parcellite clipboard manager is widely used, and I love it for my patches that strips whitespace. Go ahead, try it and enable this feature in the preferences. Czech translation is totally wrong, therefore I start it in English.

    + +
    ## OSD
    +dunst &
    + +

    And notification daemon. More about it later.

    + +

    Bar

    + +

    As I described earlier, i3bar program uses i3status – lightweight status generator designed to be very efficient by issuing a very small number of system calls. No scripting support, no external commands. Communication with i3bar is very simple using pipes, if you really need an external command, you can create a wrapper that adds some more info to the i3status output.

    + +

    Configuration is pretty straightforward, I will not comment that. I refresh the status line every four seconds, but my bar is hidden most of time, therefore refreshing is suspended which saves you even more cpu ticks!

    + +
    general {
    +  colors = true
    +  interval = 4
    +}
    +
    +order += "disk /home"
    +order += "disk /"
    +order += "run_watch VPN"
    +order += "wireless wlan0"
    +order += "ethernet em1"
    +order += "battery 0"
    +order += "volume master"
    +order += "load"
    +order += "time"
    +
    +wireless wlan0 {
    +  format_up = "W: (%quality at %essid) %ip"
    +  format_down = "W: down"
    +}
    +
    +ethernet em1 {
    +  # sudo setcap cap_net_admin=ep $(which i3status)
    +  format_up = "E: %ip (%speed)"
    +  format_down = "E: down"
    +}
    +
    +battery 0 {
    +  format = "%status %percentage %remaining"
    +}
    +
    +run_watch VPN {
    +  pidfile = "/var/run/openvpn.pid"
    +}
    +
    +time {
    +  format = "%d.%m.%Y %H:%M"
    +}
    +
    +load {
    +  format = "%1min"
    +}
    +
    +disk "/" {
    +  format = "%free"
    +}
    +
    +disk "/home" {
    +  format = "%free"
    +}
    +
    +volume master {
    +  format = "♪: %volume"
    +  device = "default"
    +  mixer = "Master"
    +  mixer_idx = 0
    +}
    + +

    To test it, you can just run i3status. It will fall back to simple text output (real communication with i3bar is with colors):

    + +
    $ i3status 
    +132,1 GB | 56,2 GB | VPN: yes | W: down | E: 192.168.1.1 (1000 Mbit/s) | FULL 55,92% | ♪: 63% | 1,56 | 28.08.2012 19:46
    + +

    As you may noticed, my ThinkPad battery is dying.

    + +

    OSD

    + +

    I use dunst as a notification daemon. It’s very simple and it looks like a dmenu. The configuration is stored in ~/.config/dunst/dunstrc and the default one works great. And it also plays well with multi-monitor setups - you can choose screen to show notifications on and it can also follow your mouse or keyboard (pops up on the screen you actually work on).

    + +

    Dunst can group same messages, stack them, sort them by urgency, wrap words and keep messages when computer is in idle (so you would miss them). One can configure colors, format and other basic things for the pop up windows.

    + +

    I took the default configuration from /usr/share/dunst/dunstrc and kept the sane defaults. The most important setting change for me was:

    + +
    close_all = mod4+n
    + +

    I use Win+n to close all notifications. Nice.

    + +

    Wrap-up

    + +

    Okay, I think I showed you i3. Highly recommended tiling window manager. Share your opinions on this page with me!

    + +

    Update: I have pushed all my configuration files to git repository.

    diff --git a/docs/user-contributed/lzap-config.html.mako b/docs/user-contributed/lzap-config.html.mako deleted file mode 100644 index 571fb86..0000000 --- a/docs/user-contributed/lzap-config.html.mako +++ /dev/null @@ -1,473 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    User-contributed article: Lukáš Zapletal’s i3 configuration

    - -

    I was keeping sight on i3 for some time after I saw Michael’s presentation at Google the other day. Last weekend, I upgraded my Fedora 17 and when I noticed i3 version 4.2 in the repositories, I gave it a try. First of all, I have to admit I’ve fallen in love. Totally.

    - -

    It’s a tiling window manager which is lightweight yet powerful. What I like about i3 is ease of adopting it. Michael, the main author of this awesome software, made the default configuration very sane. And i3 is also very fast by it’s (UNIX) design. Last but not least, i3 saves every pixel on the screen. You can get the most from your screen(s). And yes - it does support multiple screens very nicely.

    - -

    Instead of describing how it looks like when you use i3, I’d rather publish my (pretty new) configuration describing each line of it. Before I start, I need to highlight one thing. It’s a tiling window manager. You manage windows into tiles, it’s the basic idea. While you can turn windows into “normal” (the correct term is “floating”) mode, you loose lots of things and this is not the mode you want to work in. It is mainly used by i3 for dialogs, tooltips or other temporary windows.

    - -

    Installation

    - -

    Is pretty straightforward. We need i3 itself and several other highly recommended apps I will describe later. In short: simple screen locker, starter menu and simple notification daemon.

    - -
    # yum -y install i3 i3lock dmenu dunst
    - -

    Please note dunst is not in Fedora 17 repositories, but I have created a review request. Feel free to take it for review.

    - -

    Exit your desktop environment or window manager and log on into i3 from the GDM menu (if you use it). i3 will ask to create initial configuration during the first start. Say yes and do not worry - reloading/restarting i3 is fluent and you can do this zillions of times without loosing a single window.

    - -

    i3 configuration

    - -

    Configuration is located in .i3/config. Let’s do the walkthrough.

    - -
    set $mod Mod4
    - -

    i3 works best with a modifier key set to ALT (Mod1) or WIN (Mod4). I have a windows key on my keyboard unused anyway, so I use it as my main modifier key (with few exceptions bellow).

    - -
    # font for window titles. ISO 10646 = Unicode
    -font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
    - -

    Basic font for windows titles. I was experimenting with my favourite one - Terminus - but the default (misc-fixed) works great and is narrower.

    - -
    # Use Mouse+$mod to drag floating windows to their wanted position
    -floating_modifier $mod
    - -

    By default windows has 1 pixel border, so it’s difficult to resize them with mouse. With this option, you can move windows with modifier + left click and resize with modifier + right click. I bet Apple patented this already, but who cares.

    - -
    # start a terminal
    -bindsym $mod+Return exec i3-sensible-terminal
    - -

    I am starting terminals a lot. Like fifty a day, or even more. Michael’s default configuration has this binding and I keep it. By the way i3 has several i3-* scripts (three I guess) which tries to find “the best” terminal (editor etc). In my case its urxvt and vim, but i3-* will find out from ENV variables of course.

    - -
    # kill focused window
    -bindsym $mod+Shift+Q kill
    - -

    As you will notice shortly, i3 does not draw any minimize, maximize and close buttons. Except the latter, they are useless. It turns out every single application has an exit path (usually using Ctrl+q or something like that), so you don’t need the [X] button. Few apps do not support it (like very old xev), you can use this shortcut that tries to close it nicely first and it kills it if it does not work.

    - -
    # start dmenu (a program launcher)
    -bindsym $mod+d exec dmenu_run
    - -

    Do you think there is a start menu or icons on a desktop in i3? Well, it’s a window manager. Of course not. By default it uses excellent dmenu starter and this simple wrapper that ships with it. Basically, it makes a cache of all executable applications and shows them while you type in a top bar. It’s fast. It’s awesome.

    - -
    # reload/restart/exit
    -bindsym $mod+Shift+C reload
    -bindsym $mod+Shift+R restart
    -bindsym $mod+Shift+E exit
    - -

    Few default key bindings you will like when playing with configuration.

    - -
    # screen locker (first move to "safe" workspace without any chat app)
    -bindsym Control+Mod1+l exec i3-msg workspace 1 && i3lock -c 111111 -d
    - -

    My invention here. Locking a screen is an easy task, but unlocking it without providing your password to other team folks via IRC channel is a challenge (for a guy in the Pulp team ;-) therefore I switch to the first workspace first where is not my IRC chat. Ever. I have to admit the issue is more when you don’t have your screen lock, but it was fun to create this key.

    - -

    Please note i3lock built into Fedora 17 does NOT support loading of images. The software itself is capable of loading images instead of solid color, but this feature was not built. Just stick with a solid color for now.

    - -

    By the way, you just saw i3-msg command which is distributed with i3 distribution. Every single command you see here in the bindsym and exec statements can be sent to i3 using i3-msg. You can create shell scripts with starting up applications, moving them around, changing workspaces and I can’t possibly imagine what can you do with it. Everything.

    - -
    # change focus
    -bindsym $mod+j focus left
    -bindsym $mod+k focus down
    -bindsym $mod+l focus up
    -bindsym $mod+semicolon focus right
    -#bindsym $mod+uring focus right
    - -

    Default configuration for moving around. Notice this is not exactly what we know from Vim (its HJKL there). I thought I will hate it, but I got used to it in two hours. The commented line is for Czech keyboard layout (there is u with ring instead of semicolon) - ignore it if you don’t use this one.

    - -
    # alternatively, you can use the cursor keys:
    -bindsym $mod+Left focus left
    -bindsym $mod+Down focus down
    -bindsym $mod+Up focus up
    -bindsym $mod+Right focus right
    - -

    I sometimes use arrow keys, usually when I don’t have my hands in the working position. It is likely when I eat :-)

    - -
    # move focused window
    -bindsym $mod+Shift+J move left
    -bindsym $mod+Shift+K move down
    -bindsym $mod+Shift+L move up
    -bindsym $mod+Shift+colon move right
    - -

    Moving windows around is so simple with tiling managers. Just hold shift and you drag the window there.

    - -
    # alternatively, you can use the cursor keys:
    -bindsym $mod+Shift+Left move left
    -bindsym $mod+Shift+Down move down
    -bindsym $mod+Shift+Up move up
    -bindsym $mod+Shift+Right move right
    - -

    I don’t use this with arrow keys, but it’s defined by default. Why not.

    - -
    # split in horizontal orientation
    -bindsym $mod+h split h
    -
    -# split in vertical orientation
    -bindsym $mod+v split v
    - -

    This is important. By default i3 splits the screen according to the screen size. For wide screens it’s usually horizontal split. You can configure this behavior if you want, but sometimes you want to split different way. That is what these bindings are for. i3 remembers that for the workspace, so you can split multiple windows easily.

    - -
    # enter fullscreen mode for the focused container
    -bindsym $mod+f fullscreen
    - -

    Fullscreen is something you don’t use many times with standard window managers, but in tiling mode it is pretty useful. I use it a lot when I wan’t to “zoom in” a window.

    - -
    # change container layout (stacked, tabbed, default)
    -bindsym $mod+s layout stacking
    -bindsym $mod+w layout tabbed
    -bindsym $mod+e layout default
    - -

    Unique feature of i3, I would say. Best thing what you can do is to see a picture. You can switch from tiling (default) to tabbed and stacking mode. You can have multiple Firefox instances in windows tabs if you want to. By the way, the i3 User’s Guide is the definitive document you want to read twice.

    - -
    # toggle tiling / floating
    -bindsym $mod+Shift+space floating toggle
    - -

    Some applications does not work well in the tiling mode, because all windows are maximalized by default and according to your screen size and number of other containers there first application can be quite stretched. If your application looks weird, you can always switch to the floating (“normal”) mode, and back and forth with this key mapping. By default, i3 recognizes dialogs and tool windows, so you do not to switch all windows. Actually I had to switch only one application by now.

    - -
    # change focus between tiling / floating windows
    -bindsym $mod+space focus mode_toggle
    - -

    If you have multiple windows in tiling and floating mode, you want to switch between those two groups. You do it with this key.

    - -
    # focus the parent container
    -#bindsym $mod+a focus parent
    -
    -# focus the child container
    -#bindcode $mod+d focus child
    - -

    I have to admit I never used this, because I try to keep number of windows on each workspace low (up to 6 I would say). It moves focus to parent or child window, perhaps more usable with more windows. Share your experiences with this. Notice it’s disabled because I use mod+d for the dmenu.

    - -
    # next/previous workspace
    -bindsym Mod1+Tab focus right
    -bindsym Mod1+Shift+Tab focus left
    -bindsym $mod+Tab workspace back_and_forth
    - -

    This is not standard binding, but I find Alt+Tab pretty useful combination. It’s handy (I use my right hand for mouse) and it was not used by i3. So I started using it for cycling through windows on one workspace. If you have various (horizontal and vertical splits), it does not cycle through all of them. It’s only moving in vertical movement (right - left). I wish there has been a option like “focus cycle” in the next i3 version.

    - -

    Shift does the other way around while Win+Tab switches to the last used weapon. Sorry, I said weapon? I mean workspace.

    - -
    # switch to workspace
    -bindsym $mod+ampersand workspace 1
    -bindsym $mod+eacute workspace 2
    -bindsym $mod+quotedbl workspace 3
    -bindsym $mod+apostrophe workspace 4
    -bindsym $mod+parenleft workspace 5
    -bindsym $mod+minus workspace 6
    -bindsym $mod+egrave workspace 7
    -bindsym $mod+underscore workspace 8
    -bindsym $mod+ccedilla workspace 9
    -bindsym $mod+agrave workspace 10
    -#bindsym $mod+1 workspace 1
    -#bindsym $mod+2 workspace 2
    -#bindsym $mod+3 workspace 3
    -#bindsym $mod+4 workspace 4
    -#bindsym $mod+5 workspace 5
    -#bindsym $mod+6 workspace 6
    -#bindsym $mod+7 workspace 7
    -#bindsym $mod+8 workspace 8
    -#bindsym $mod+9 workspace 9
    -#bindsym $mod+0 workspace 10
    -
    -# switch to workspace (f1-f4)
    -bindsym F1 workspace 1
    -bindsym F2 workspace 2
    -bindsym F3 workspace 3
    -bindsym F4 workspace 4
    -bindsym Mod1+F1 workspace 5
    -bindsym Mod1+F2 workspace 6
    -bindsym Mod1+F3 workspace 7
    -bindsym Mod1+F4 workspace 8
    - -

    Okay, the first block is default binding. But for many years I decided to leverage F1-F4 keys for workspace movement. Until now, I was using only four workspaces (OpenBox, KDE/GNOME, Fluxbox and XFce), but with i3 and its good support of multiple screens I can afford eight now. Each screen has four independent workspaces.

    - -

    Please note the commented part is for Czech layout, therefore if you use this layout uncomment it and delete the above.

    - -

    Now let me explain function keys a bit. First of all I realized many years ago that no one (including me) ever use F1 key. It’s reserved, it’s for help. But everybody is googling these days instead searching through built-in docs. The same for F2, F3 and F4. Maybe some IDEs offer some important stuff, but I use Vim that has no function keys binding. That is the reason why I gave up with those keys and use them for workspace switching.

    - -

    With i3 I have decided also to map Alt+F1-F4 for accessing numbers five to eight. It just seem natural for me now. I am giving up with Alt-F2 (Run App in GNOME) or Alt-F4 (Close App), but this does no work in i3 anymore. Few apps still react on Alt-F4, but there is a different combination available for that.

    - -

    If you occasionally need those keys, you can create a re-mapping that would trigger them with Win+F1-F4 keys. But in terminals you can always use ESC combination (ESC;1 for F1). I don’t use any X11 application that needs that.

    - -

    Therefore workspaces 1-4 are on the laptop screen (LDVS1) and 5-8 are on the main monitor (HDMI1). And there is one workspace hidden called scratch one. More about it later.

    - -
    # move focused container to workspace
    -bindsym $mod+Shift+1 move container to workspace 1
    -bindsym $mod+Shift+2 move container to workspace 2
    -bindsym $mod+Shift+3 move container to workspace 3
    -bindsym $mod+Shift+4 move container to workspace 4
    -bindsym $mod+Shift+5 move container to workspace 5
    -bindsym $mod+Shift+6 move container to workspace 6
    -bindsym $mod+Shift+7 move container to workspace 7
    -bindsym $mod+Shift+8 move container to workspace 8
    -bindsym $mod+Shift+9 move container to workspace 9
    -bindsym $mod+Shift+0 move container to workspace 10
    - -

    Default setting for transferring windows (containers) among workspaces. Those works for both Czech and English layout and are installed by default.

    - -
    # border changing
    -bindsym $mod+b border toggle
    - -

    I cycle through normal, 1pixel and none values with this keybinding. By default it’s bound to mod+t, mod+y and mod+u.

    - -
    # scratchpad
    -bindsym $mod+m move scratchpad
    -bindsym $mod+o scratchpad show
    - -

    Now THIS is cool. There is one hidden workspace that is nowhere and everywhere. It’s empty by default, thus invisible. You can move there any window you want with mod+m. Container is switched over to floating mode and it’s centered on the screen giving it some decent size. Than you can quickly show this window with mod+o key. If you hit it twice, it disappears.

    - -

    This is cool feature, I like to have an extra terminal there for quick looks while I am working. Maybe you want your favourite e-mail application there. Or something other you want to keep hiddennhandy.

    - -

    Please note floating applications always stays on top of tiled containers. So scratchpad is not intended for long tasks. It’s better for short tasks you need to do many times a day. Oh, you can open scratchpad on top of any workspace you want. This is also great for copy and paste.

    - -
    # resize window (you can also use the mouse for that)
    -mode "resize" {
    -  # These bindings trigger as soon as you enter the resize mode
    -  bindsym j resize shrink width 10 px or 10 ppt
    -  bindsym k resize grow height 10 px or 10 ppt
    -  bindsym l resize shrink height 10 px or 10 ppt
    -  bindsym semicolon resize grow width 10 px or 10 ppt
    -  #bindsym uring resize grow width 10 px or 10 ppt
    -
    -  # same bindings, but for the arrow keys
    -  bindsym 113 resize shrink width 10 px or 10 ppt
    -  bindsym 116 resize grow height 10 px or 10 ppt
    -  bindsym 111 resize shrink height 10 px or 10 ppt
    -  bindsym 114 resize grow width 10 px or 10 ppt
    -
    -  # back to normal: Enter or Escape
    -  bindsym Return mode "default"
    -  bindsym Escape mode "default"
    -}
    -
    -bindsym $mod+r mode "resize"
    - -

    I like to resize windows with mouse, but with keys it’s more fun and also much faster. I need to get used to it. You enter resize mode with mod+r combination, then usint JKL and semicolon (note uring for my Czech layout) you change the window size. And than you must switch back to the normal mode with ESC or ENTER key. Standard key bindings are not available in the resize mode and you will notice why nothing is working. Remember, you need to return.

    - -

    I bet you can create your own modes like “work” and “fun” with totally different key bindings. Never tried this.

    - -
    # pulse audio volume control
    -bindsym XF86AudioLowerVolume exec /usr/bin/pactl set-sink-volume 0 -- '-5%'
    -bindsym XF86AudioRaiseVolume exec /usr/bin/pactl set-sink-volume 0 -- '+5%'
    -bindsym XF86AudioMute exec /usr/bin/pactl set-sink-volume 0 0
    -bindsym XF86Launch1 exec /usr/bin/pactl play-sample that_was_easy
    -bindsym XF86MonBrightnessUp exec /usr/bin/xbacklight -inc 10
    -bindsym XF86MonBrightnessDown exec /usr/bin/xbacklight -dec 5
    - -

    Few ThinkPad laptop key bindings for controlling volume, brightness and ThinkVantage for playing That Was Easy (TM) sample just for fun. I don’t use laptop keyboard much.

    - -
    # $mod+n reserved for close all notifications
    -# see ~/.config/dunst/dunstrc for more
    - -

    Just a note for myself not to override mod+n which is used by dunst. More about it later.

    - -
    # one bar on both screens
    -bar {
    -  position top
    -  mode hide
    -  modifier $mod
    -  status_command i3status
    -  tray_output LVDS1
    -}
    - -

    i3 uses i3bar application to draw a very minimalistic bar that can be positioned on the top or bottom of the screen (all screens by default). I like having my bar on top. Content of the bar is delivered with an external program using IPC - i3status in my case. More about its configuration later.

    - -

    Only one bar can contain tray area - laptop screen in my case. The bar is very thin, tray icons are also small. I like it. The “mode hide” statement hides the bar and opens it once I hit “modifier” key, or on a workspace highlight. By the way when the bar is hidden, i3 also notifies the i3status program so it’s not feeding with data to save CPU time and thus battery.

    - -

    By default i3bar shows workspaces and you can switch them with a mouse. It’s good not to disable this (even if you don’t use mouse for that) just to have a nice overview about all workspaces which are kind a dynamic (like in GNOME 3), they appear once you move there for the first time and disappear when you leave it (and there is no other container on it). Therefore you can work with them like in GNOME 3 if you want. I have my numbers 9 and 10 ready for that.

    - -
    # workspace screens
    -workspace 1 output HDMI1
    -workspace 2 output HDMI1
    -workspace 3 output HDMI1
    -workspace 4 output HDMI1
    -workspace 5 output LVDS1
    -workspace 6 output LVDS1
    -workspace 7 output LVDS1
    -workspace 8 output LVDS1
    - -

    i3 works very well with multiple monitors. The default behavior is where you create a workspace it stays there forever, or until you disconnect the screen respectively. Therefore it’s up to you where you create your workspaces.

    - -

    I like to have an order in this, workspaces 1-4 are on the main screen, 5-8 are on the laptop. Therefore I explicitly say this in my configuration. By the way you can easily move workspaces across screens, but I don’t use any key bindings for that.

    - -

    When you disconnect your laptop from dock, everything stays “as is” until xrandr notice the screen is off. This is not by default and I like this behavior (depends on your distribution). You can switch off the screen using xranrd command, but sometimes I prefer to attend a meeting or something and then returning without any change (having workspaces on the main screen invisible for a while). I like to have an option in this case. Of course once i3 determines screen has been turned off using xrandr, it moves all workspaces to the remaining screen.

    - -

    You can also do this manually with i3-msg workspace N output OUTPUT therefore I created two bash scripts dock and undock that transfers all my workspaces in/out of LDVDS1. This is awesome, I really love this feature. I have never seen a window manager that plays THAT nicely with multiple screens.

    - -
    # workspace assignment (use "xprop")
    -assign [class="^Google-chrome$"] 3
    -assign [class="^URxvt$" instance="^mail$"] 4
    -assign [class="^Xchat$"] 5
    -assign [class="^Rednotebook$"] 6
    -assign [class="^Decibel-audio-player.py$"] 7
    -assign [title="Lingea Lexicon 5$"] 8
    -
    -# custom window settings
    -for_window [class="^URxvt$" instance="scratchpad"] border 1pixel; move scratchpad
    -for_window [class="^Google-chrome$"] border none
    -for_window [title="Lingea Lexicon 5$"] border none
    -
    -# get elluminate working
    -for_window [title="^Elluminate Live!"] floating enable
    -for_window [title="^Application Sharing"] floating enable
    -for_window [class="^net-sourceforge-jnlp-runtime-Boot$" title="^Downloading"] floating enable
    - -

    In this block, I force some applications to start on specific screens. You can see apps that I use everyday. IRC chat, notebook, audio player, dictionary, browser and that’s it.

    - -

    Than if I start a terminal with the name of “scratchpad” it changes its border to 1pixel and moves to the background – scratchpad, remember? This is cool.

    - -

    And I need to use Elluminate application for desktop sharing and meetings. It’s a Java application that does not look nice in the tiled mode, therefore I force it into floating mode. Good news is it is working actually, if you use it with Sun JRE. There are not many window managers Elluminate is working in, seriously.

    - -
    # before autostart
    -exec --no-startup-id pactl upload-sample ~/.i3/that_was_easy.wav that_was_easy
    -exec urxvt -name scratchpad -e bash
    -exec ~/.i3/autostart
    -
    -# autostart
    -exec google-chrome
    -exec urxvt -name mail -e bash -c "mutt"
    -exec xchat
    -exec rednotebook
    -exec decibel-audio-player
    -exec lexicon
    - -

    The last block is just auto starting some applications during startup. I load the funny sample, open a scratchpad terminal (which goes to the background automatically) and then I start a shell script with additional commands. I could put this into .xinitrc, but I keep it here. And then some applications.

    - -

    When I start my laptop, I get the same. Everyday. Cool, isn’t it?

    - -

    Autostart

    - -

    My autostart script triggers some settings and spawns some daemons. It’s totally optional in i3, you could do everything using “exec” commands, but I leveraged my old xinitrc script for that. Let’s do the showcase again.

    - -
    #!/bin/sh
    -
    -## Desktop background color
    -xsetroot -solid '#101010' &
    - -

    Again, i3 is a window manager, not a desktop environment. I don’t like “wallpapers, I just set a decent color here.

    - -
    ## Set startup volume
    -pactl set-sink-volume 0 '20%' &
    - -

    I hate random volume after start. Can cause injuries with my speakers. Every time I start my laptop, volume is set to 20 per cent.

    - -
    ## Disable beeps
    -xset -b &
    - -

    Don’t like PC-speaker beeping at all.

    - -
    ## Keybord layout setting
    -setxkbmap -layout cz,us -option grp:shift_shift_toggle &
    - -

    I told you – Czech layout.

    - -
    ## DPMS monitor setting (standby -> suspend -> off) (seconds)
    -xset dpms 300 600 900 &
    - -

    I do not use screen “savers”, blank it after 5 minutes, suspend and then go off after 5+5 minutes. THIS is screen saving.

    - -
    ## Set LCD brightness
    -xbacklight -set 90 &
    - -

    The same story as with volume, backlight set to 90 % after start.

    - -
    ## Clipboard manager
    -LC_ALL=C parcellite &
    - -

    Parcellite clipboard manager is widely used, and I love it for my patches that strips whitespace. Go ahead, try it and enable this feature in the preferences. Czech translation is totally wrong, therefore I start it in English.

    - -
    ## OSD
    -dunst &
    - -

    And notification daemon. More about it later.

    - -

    Bar

    - -

    As I described earlier, i3bar program uses i3status – lightweight status generator designed to be very efficient by issuing a very small number of system calls. No scripting support, no external commands. Communication with i3bar is very simple using pipes, if you really need an external command, you can create a wrapper that adds some more info to the i3status output.

    - -

    Configuration is pretty straightforward, I will not comment that. I refresh the status line every four seconds, but my bar is hidden most of time, therefore refreshing is suspended which saves you even more cpu ticks!

    - -
    general {
    -  colors = true
    -  interval = 4
    -}
    -
    -order += "disk /home"
    -order += "disk /"
    -order += "run_watch VPN"
    -order += "wireless wlan0"
    -order += "ethernet em1"
    -order += "battery 0"
    -order += "volume master"
    -order += "load"
    -order += "time"
    -
    -wireless wlan0 {
    -  format_up = "W: (%quality at %essid) %ip"
    -  format_down = "W: down"
    -}
    -
    -ethernet em1 {
    -  # sudo setcap cap_net_admin=ep $(which i3status)
    -  format_up = "E: %ip (%speed)"
    -  format_down = "E: down"
    -}
    -
    -battery 0 {
    -  format = "%status %percentage %remaining"
    -}
    -
    -run_watch VPN {
    -  pidfile = "/var/run/openvpn.pid"
    -}
    -
    -time {
    -  format = "%d.%m.%Y %H:%M"
    -}
    -
    -load {
    -  format = "%1min"
    -}
    -
    -disk "/" {
    -  format = "%free"
    -}
    -
    -disk "/home" {
    -  format = "%free"
    -}
    -
    -volume master {
    -  format = "♪: %volume"
    -  device = "default"
    -  mixer = "Master"
    -  mixer_idx = 0
    -}
    - -

    To test it, you can just run i3status. It will fall back to simple text output (real communication with i3bar is with colors):

    - -
    $ i3status 
    -132,1 GB | 56,2 GB | VPN: yes | W: down | E: 192.168.1.1 (1000 Mbit/s) | FULL 55,92% | ♪: 63% | 1,56 | 28.08.2012 19:46
    - -

    As you may noticed, my ThinkPad battery is dying.

    - -

    OSD

    - -

    I use dunst as a notification daemon. It’s very simple and it looks like a dmenu. The configuration is stored in ~/.config/dunst/dunstrc and the default one works great. And it also plays well with multi-monitor setups - you can choose screen to show notifications on and it can also follow your mouse or keyboard (pops up on the screen you actually work on).

    - -

    Dunst can group same messages, stack them, sort them by urgency, wrap words and keep messages when computer is in idle (so you would miss them). One can configure colors, format and other basic things for the pop up windows.

    - -

    I took the default configuration from /usr/share/dunst/dunstrc and kept the sane defaults. The most important setting change for me was:

    - -
    close_all = mod4+n
    - -

    I use Win+n to close all notifications. Nice.

    - -

    Wrap-up

    - -

    Okay, I think I showed you i3. Highly recommended tiling window manager. Share your opinions on this page with me!

    - -

    Update: I have pushed all my configuration files to git repository.

    diff --git a/docs/user-contributed/py3status.html b/docs/user-contributed/py3status.html new file mode 100644 index 0000000..edfeb17 --- /dev/null +++ b/docs/user-contributed/py3status.html @@ -0,0 +1,73 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    User-contributed article: enhanced and extensible i3bar with py3status

    + +

    +In the i3 documentation, the recommended tool for displaying +a status line is to use i3status combined with i3bar. +

    + +

    +While i3status is very efficient at what it does, it is by design limited to +a few modules and does not allow you to inject your own scripts output on your +i3bar. This is said pretty clearly on the i3status man page: +

    + +
    In i3status, we don’t want to implement process management again.
    +Therefore, there is no module to run arbitrary scripts or commands.
    +Instead, you should use your shell.
    + +

    Introducing py3status

    + +

    +The goal of py3status is to fill this gap by allowing users to simply extend +their i3bar while preserving their current i3status configuration. The main idea +is to rely on i3status' strengths without adding any configuration on the user's +side. py3status is thus a wrapper script for i3status and you can + read more on the wiki. +

    + +

    Requirements

    + +

    +To achieve this, py3status uses the i3bar protocol so your +i3status.conf should specify this as its output_format. +

    + +
    general {
    +    output_format = "i3bar"
    +}
    + +

    Usage

    + +

    +Using py3status is easy, no need to multi-pipe your scripts after i3status. +Instead, just replace i3status in your current status_command by py3status. +For example, if you're using your own i3status.conf, you need to change your +i3 config file with: +

    + +
    status_command py3status -c ~/.i3/i3status.conf
    + +

    Display your own stuff

    + +

    +py3status features a simple and straightforward plugin system which you can use +to get your own output displayed on your i3bar. You can read more and view some +examples on the +wiki. +

    + +

    Documentation

    + +

    +You can read the full and up to date documentation on the py3status home page. +

    diff --git a/docs/user-contributed/py3status.html.mako b/docs/user-contributed/py3status.html.mako deleted file mode 100644 index 527b199..0000000 --- a/docs/user-contributed/py3status.html.mako +++ /dev/null @@ -1,72 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    User-contributed article: enhanced and extensible i3bar with py3status

    - -

    -In the i3 documentation, the recommended tool for displaying -a status line is to use i3status combined with i3bar. -

    - -

    -While i3status is very efficient at what it does, it is by design limited to -a few modules and does not allow you to inject your own scripts output on your -i3bar. This is said pretty clearly on the i3status man page: -

    - -
    In i3status, we don’t want to implement process management again.
    -Therefore, there is no module to run arbitrary scripts or commands.
    -Instead, you should use your shell.
    - -

    Introducing py3status

    - -

    -The goal of py3status is to fill this gap by allowing users to simply extend -their i3bar while preserving their current i3status configuration. The main idea -is to rely on i3status' strengths without adding any configuration on the user's -side. py3status is thus a wrapper script for i3status and you can - read more on the wiki. -

    - -

    Requirements

    - -

    -To achieve this, py3status uses the i3bar protocol so your -i3status.conf should specify this as its output_format. -

    - -
    general {
    -    output_format = "i3bar"
    -}
    - -

    Usage

    - -

    -Using py3status is easy, no need to multi-pipe your scripts after i3status. -Instead, just replace i3status in your current status_command by py3status. -For example, if you're using your own i3status.conf, you need to change your -i3 config file with: -

    - -
    status_command py3status -c ~/.i3/i3status.conf
    - -

    Display your own stuff

    - -

    -py3status features a simple and straightforward plugin system which you can use -to get your own output displayed on your i3bar. You can read more and view some -examples on the -wiki. -

    - -

    Documentation

    - -

    -You can read the full and up to date documentation on the py3status home page. -

    diff --git a/docs/user-contributed/swapping-workspaces.html b/docs/user-contributed/swapping-workspaces.html new file mode 100644 index 0000000..a1278ef --- /dev/null +++ b/docs/user-contributed/swapping-workspaces.html @@ -0,0 +1,57 @@ +--- +layout: default +title: Docs +group: Docs +--- +
    +

    User-contributed article: Swapping workspaces

    + +

    +If you have workspace 1 on one monitor and workspace 2 on another monitor and +want to quickly swap the workspaces among the monitors, you can use i3's IPC +mechanisms to do it. Here's how: +

    + +

    +i3 already includes a way to move an individual workspace from one monitor to +another. But what we want to achieve is the simultaneous +movement of workspaces between the monitors. To do this, we can write a script +that detects the currently active workspace on each monitor and then moves that +workspace to the other monitor. +

    + +

    +The script uses i3's IPC via the +i3-py Python bindings. +

    + +
    #!/usr/bin/python2.7
    +
    +import i3
    +outputs = i3.get_outputs()
    +
    +# set current workspace to output 0
    +i3.workspace(outputs[0]['current_workspace'])
    +
    +# ..and move it to the other output.
    +# outputs wrap, so the right of the right is left ;)
    +i3.command('move', 'workspace to output right')
    +
    +# rinse and repeat
    +i3.workspace(outputs[1]['current_workspace'])
    +i3.command('move', 'workspace to output right')
    + +

    +A very simple way to use this script is as follows: Put the script in a file, +named for example switch.py, and put switch.py and i3.py (downloaded from the +Python bindings site) in the +same folder. I typically put it in $HOME/.i3/, the same directory which +contains i3's config file. Next, put a keybinding like +

    +
    bindsym $mod+Shift+s exec /home/username/.i3/switch.py
    +

    +in i3's config file and restart i3 in place. The next time you press +mod+Shift+s, your workspaces will be swapped among your monitors. +

    + +

    Author: Sagar Behere

    diff --git a/docs/user-contributed/swapping-workspaces.html.mako b/docs/user-contributed/swapping-workspaces.html.mako deleted file mode 100644 index 021f458..0000000 --- a/docs/user-contributed/swapping-workspaces.html.mako +++ /dev/null @@ -1,56 +0,0 @@ -<%! - section = "docs" -%> -<%inherit file="_templates/i3.mako" /> -
    -

    User-contributed article: Swapping workspaces

    - -

    -If you have workspace 1 on one monitor and workspace 2 on another monitor and -want to quickly swap the workspaces among the monitors, you can use i3's IPC -mechanisms to do it. Here's how: -

    - -

    -i3 already includes a way to move an individual workspace from one monitor to -another. But what we want to achieve is the simultaneous -movement of workspaces between the monitors. To do this, we can write a script -that detects the currently active workspace on each monitor and then moves that -workspace to the other monitor. -

    - -

    -The script uses i3's IPC via the -i3-py Python bindings. -

    - -
    #!/usr/bin/python2.7
    -
    -import i3
    -outputs = i3.get_outputs()
    -
    -# set current workspace to output 0
    -i3.workspace(outputs[0]['current_workspace'])
    -
    -# ..and move it to the other output.
    -# outputs wrap, so the right of the right is left ;)
    -i3.command('move', 'workspace to output right')
    -
    -# rinse and repeat
    -i3.workspace(outputs[1]['current_workspace'])
    -i3.command('move', 'workspace to output right')
    - -

    -A very simple way to use this script is as follows: Put the script in a file, -named for example switch.py, and put switch.py and i3.py (downloaded from the -Python bindings site) in the -same folder. I typically put it in $HOME/.i3/, the same directory which -contains i3's config file. Next, put a keybinding like -

    -
    bindsym $mod+Shift+s exec /home/username/.i3/switch.py
    -

    -in i3's config file and restart i3 in place. The next time you press -mod+Shift+s, your workspaces will be swapped among your monitors. -

    - -

    Author: Sagar Behere

    diff --git a/downloads/index.html b/downloads/index.html new file mode 100644 index 0000000..95eed98 --- /dev/null +++ b/downloads/index.html @@ -0,0 +1,346 @@ +--- +layout: default +title: downloads +require_jquery: true +javascript: downloads.min.js +js_callback: initDownloads(); +--- + +
    + +

    Distributions

    + +

    +Please use the i3 packages provided by the distribution you are using. i3 is +currently distributed in the following operating systems/distributions: +

    + +
    +{% include downloadlogo.html title="Debian GNU/Linux" link="http://packages.debian.org/sid/i3" img="/img/debian.svg" height=93 %} +{% include downloadlogo.html title="Arch Linux" link="http://www.archlinux.org/packages/community/x86_64/i3-wm/" img="/img/archlinux.svg" height=75 %} +{% include downloadlogo.html title="Gentoo Linux" link="http://packages.gentoo.org/package/x11-wm/i3" img="/img/gentoo-logo.svg" height=79 %} +{% include downloadlogo.html title="Ubuntu Linux" link="http://packages.ubuntu.com/i3" img="/img/ubuntu.svg" height=75 %} +{% include downloadlogo.html title="FreeBSD" link="http://www.freebsd.org/cgi/cvsweb.cgi/ports/x11-wm/i3/" img="/img/freebsd.png" height=59 %} +{% include downloadlogo.html title="NetBSD" link="http://pkgsrc.se/wip/i3" img="/img/netbsd_logo.svg" height=56 %} +
    +{% include downloadlogo.html title="OpenBSD" link="http://www.openbsd.org/cgi-bin/cvsweb/ports/x11/i3/" img="/img/Openbsd2.png" height=49 %} +{% include downloadlogo.html title="openSUSE" link="http://software.opensuse.org/package/i3" img="/img/opensuse.svg" height=48 %} +{% include downloadlogo.html title="Mageia" link="http://mageia.madb.org/package/show/application/0/name/i3" img="/img/mageia.png" height=85 %} +{% include downloadlogo.html title="Fedora" link="https://admin.fedoraproject.org/pkgdb/acls/name/i3" img="/img/fedora.svg" height=75 %} +{% include downloadlogo.html title="Exherbo" link="http://git.exherbo.org/summer/packages/x11-wm/i3/index.html" img="/img/exherbo.svg" height=85 %} +{% include downloadlogo.html title="Pibang Linux" link="http://pibanglinux.org/" img="/img/pibang.png" height=61 %} +
    +{% include downloadlogo.html title="Slackware" link="http://slackbuilds.org/desktop/i3/" img="/img/slackware.svg" height=75 %} +
    + +

    +We also provide Debian and Ubuntu repositories with up-to-date packages. +

    + +

    Downloads

    + +

    + The current stable version is 4.8. +

    + +

    + IMPORTANT: If you use the nVidia binary driver, ensure you + are using version 302.17 or newer. Read this document for an explanation and how + to enable the work-around for older versions. +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    VersionDownloadSizeSignatureRelease dateRelease notes
    4.8i3-4.8.tar.bz2918 KiBsignature2014-06-15release notes
    4.7.2i3-4.7.2.tar.bz2877 KiBsignature2014-01-23release notes
    4.7.1i3-4.7.1.tar.bz2877 KiBsignature2014-01-21release notes
    4.7i3-4.7.tar.bz2876 KiBsignature2013-12-22release notes
    4.6i3-4.6.tar.bz2871 KiBsignature2013-08-07release notes
    4.5.1i3-4.5.1.tar.bz2859 KiBsignature2013-03-18release notes
    4.5i3-4.5.tar.bz2859 KiBsignature2013-03-12release notes
    4.4i3-4.4.tar.bz2864 KiBsignature2012-12-12release notes
    4.3i3-4.3.tar.bz2833 KiBsignature2012-09-19release notes
    4.2i3-4.2.tar.bz2741 KiBsignature2012-04-25release notes
    4.1.2i3-4.1.2.tar.bz2550 KiBsignature2012-01-27release notes
    4.1.1i3-4.1.1.tar.bz2551 KiBsignature2011-12-24release notes
    4.1i3-4.1.tar.bz2551 KiBsignature2011-11-11release notes
    4.0.2i3-4.0.2.tar.bz2465 KiBsignature2011-08-28release notes
    4.0.1i3-4.0.1.tar.bz2462 KiBsignature2011-08-01release notes
    4.0i3-4.0.tar.bz2462 KiBsignature2011-07-31release notes
    3.ε-bf3i3-3.e-bf3.tar.bz2353 KiBsignature2011-05-08release notes
    3.ε-bf2i3-3.e-bf2.tar.bz2285 KiBsignature2011-01-19release notes
    3.ε-bf1i3-3.e-bf1.tar.bz2285 KiBsignature2010-06-09release notes
    3.εi3-3.e.tar.bz2271 KiBsignature2010-03-30release notes
    3.δ-bf1i3-3.d-bf1.tar.bz2153 KiBsignature2009-12-21release notes
    3.δi3-3.d.tar.bz2153 KiBsignature2009-11-09release notes
    3.γi3-3.c.tar.bz2107 KiBsignature2009-08-19release notes
    3.βi3-3.b.tar.bz296 KiBsignature2009-06-26release notes
    3.α-bf2i3-3.a-bf2.tar.bz265 KiBsignature2009-05-03release notes
    3.α-bf1i3-3.a-bf1.tar.bz265 KiBsignature2009-05-03release notes
    3.αi3-3.a.tar.bz250 KiBsignature2009-03-15release notes
    + + +

    Development version

    + +

    + Use git to follow the latest changes or + view them on this webpage. This command checks out the 'master' + branch: +

    + +
    +  $ git clone git://code.i3wm.org/i3
    +
    + +

    + The 'master' branch is the current stable version plus bugfixes.
    + The 'next' branch is the next version, yet to be released. Use git + checkout next to switch to the 'next' branch. +

    + +

    + If you prefer to download a tarball, or if you cannot use git for whatever reason, + you may download the current master branch from + + http://code.i3wm.org/i3/snapshot/i3-master.tar.bz2 + +

    + +

    Announce mailing list

    + +

    + If you want to be notified when a new version of i3 is released, please subscribe + to the announce mailing list by sending a mail to i3-announce-subscribe@i3.zekjur.net +

    + + +
    diff --git a/downloads/index.html.mako b/downloads/index.html.mako deleted file mode 100644 index b9f833e..0000000 --- a/downloads/index.html.mako +++ /dev/null @@ -1,421 +0,0 @@ -<%! - section = "downloads" - javascript = 'downloads.min.js' - require_jquery = True - js_callback = 'initDownloads();' -%> -<%inherit file="_templates/i3.mako" /> -
    - -

    Distributions

    - -

    -Please use the i3 packages provided by the distribution you are using. i3 is -currently distributed in the following operating systems/distributions: -

    - -
    -<% - distros = [ - [ - "Debian GNU/Linux", - "http://packages.debian.org/sid/i3", - "/img/debian.svg", - 93 - ], - [ - "Arch Linux", - "http://www.archlinux.org/packages/community/x86_64/i3-wm/", - "/img/archlinux.svg", - 75 - ], - [ - "Gentoo Linux", - "http://packages.gentoo.org/package/x11-wm/i3", - "/img/gentoo-logo.svg", - 79 - ], - [ - "Ubuntu Linux", - "http://packages.ubuntu.com/i3", - "/img/ubuntu.svg", - 75 - ], - [ - "FreeBSD", - "http://www.freebsd.org/cgi/cvsweb.cgi/ports/x11-wm/i3/", - "/img/freebsd.png", - 59 - ], - [ - "NetBSD", - "http://pkgsrc.se/wip/i3", - "/img/netbsd_logo.svg", - 56 - ], - [ - "OpenBSD", - "http://www.openbsd.org/cgi-bin/cvsweb/ports/x11/i3/", - "/img/Openbsd2.png", - 49 - ], - [ - "openSUSE", - "http://software.opensuse.org/package/i3", - "/img/opensuse.svg", - 48 - ], - [ - "Mageia", - "http://mageia.madb.org/package/show/application/0/name/i3", - "/img/mageia.png", - 85 - ], - [ - "Fedora", - "https://admin.fedoraproject.org/pkgdb/acls/name/i3", - "/img/fedora.svg", - 75 - ], - [ - "Exherbo", - "http://git.exherbo.org/summer/packages/x11-wm/i3/index.html", - "/img/exherbo.svg", - 85 - ], - [ - "Pibang Linux", - "http://pibanglinux.org/", - "/img/pibang.png", - 61 - ], - [ - "Slackware", - "http://slackbuilds.org/desktop/i3/", - "/img/slackware.svg", - 75 - ], - ] - - c = 0 -%> -% for title, link, img, height in distros: -
    ${title}
    -<% c += 1 %> -% if c % 6 == 0: -
    -% endif -% endfor -
    - -

    -We also provide Debian and Ubuntu repositories with up-to-date packages. -

    - -

    Downloads

    - -

    - The current stable version is 4.8. -

    - -

    - IMPORTANT: If you use the nVidia binary driver, ensure you - are using version 302.17 or newer. Read this document for an explanation and how - to enable the work-around for older versions. -

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    VersionDownloadSizeSignatureRelease dateRelease notes
    4.8i3-4.8.tar.bz2918 KiBsignature2014-06-15release notes
    4.7.2i3-4.7.2.tar.bz2877 KiBsignature2014-01-23release notes
    4.7.1i3-4.7.1.tar.bz2877 KiBsignature2014-01-21release notes
    4.7i3-4.7.tar.bz2876 KiBsignature2013-12-22release notes
    4.6i3-4.6.tar.bz2871 KiBsignature2013-08-07release notes
    4.5.1i3-4.5.1.tar.bz2859 KiBsignature2013-03-18release notes
    4.5i3-4.5.tar.bz2859 KiBsignature2013-03-12release notes
    4.4i3-4.4.tar.bz2864 KiBsignature2012-12-12release notes
    4.3i3-4.3.tar.bz2833 KiBsignature2012-09-19release notes
    4.2i3-4.2.tar.bz2741 KiBsignature2012-04-25release notes
    4.1.2i3-4.1.2.tar.bz2550 KiBsignature2012-01-27release notes
    4.1.1i3-4.1.1.tar.bz2551 KiBsignature2011-12-24release notes
    4.1i3-4.1.tar.bz2551 KiBsignature2011-11-11release notes
    4.0.2i3-4.0.2.tar.bz2465 KiBsignature2011-08-28release notes
    4.0.1i3-4.0.1.tar.bz2462 KiBsignature2011-08-01release notes
    4.0i3-4.0.tar.bz2462 KiBsignature2011-07-31release notes
    3.ε-bf3i3-3.e-bf3.tar.bz2353 KiBsignature2011-05-08release notes
    3.ε-bf2i3-3.e-bf2.tar.bz2285 KiBsignature2011-01-19release notes
    3.ε-bf1i3-3.e-bf1.tar.bz2285 KiBsignature2010-06-09release notes
    3.εi3-3.e.tar.bz2271 KiBsignature2010-03-30release notes
    3.δ-bf1i3-3.d-bf1.tar.bz2153 KiBsignature2009-12-21release notes
    3.δi3-3.d.tar.bz2153 KiBsignature2009-11-09release notes
    3.γi3-3.c.tar.bz2107 KiBsignature2009-08-19release notes
    3.βi3-3.b.tar.bz296 KiBsignature2009-06-26release notes
    3.α-bf2i3-3.a-bf2.tar.bz265 KiBsignature2009-05-03release notes
    3.α-bf1i3-3.a-bf1.tar.bz265 KiBsignature2009-05-03release notes
    3.αi3-3.a.tar.bz250 KiBsignature2009-03-15release notes
    - - -

    Development version

    - -

    - Use git to follow the latest changes or - view them on this webpage. This command checks out the 'master' - branch: -

    - -
    -  $ git clone git://code.i3wm.org/i3
    -
    - -

    - The 'master' branch is the current stable version plus bugfixes.
    - The 'next' branch is the next version, yet to be released. Use git - checkout next to switch to the 'next' branch. -

    - -

    - If you prefer to download a tarball, or if you cannot use git for whatever reason, - you may download the current master branch from - - http://code.i3wm.org/i3/snapshot/i3-master.tar.bz2 - -

    - -

    Announce mailing list

    - -

    - If you want to be notified when a new version of i3 is released, please subscribe - to the announce mailing list by sending a mail to i3-announce-subscribe@i3.zekjur.net -

    - - -
    diff --git a/i3bar/index.html b/i3bar/index.html new file mode 100644 index 0000000..4ea29ca --- /dev/null +++ b/i3bar/index.html @@ -0,0 +1,22 @@ +--- +layout: default +title: i3bar +--- +
    + +

    i3bar

    + +

    + i3bar displays a bar at the bottom (or top) of your monitor(s) containing + workspace switching buttons and a statusline generated by i3status(1) or + similar. It is automatically invoked (and configured through) i3. +

    + +

    Documentation

    + +

    + The documentation for i3bar is its manpage. You can also view the manpage online. +

    + +
    diff --git a/i3bar/index.html.mako b/i3bar/index.html.mako deleted file mode 100644 index 1ecc6e4..0000000 --- a/i3bar/index.html.mako +++ /dev/null @@ -1,22 +0,0 @@ -<%! - section = "i3bar" -%> -<%inherit file="_templates/i3.mako" /> -
    - -

    i3bar

    - -

    - i3bar displays a bar at the bottom (or top) of your monitor(s) containing - workspace switching buttons and a statusline generated by i3status(1) or - similar. It is automatically invoked (and configured through) i3. -

    - -

    Documentation

    - -

    - The documentation for i3bar is its manpage. You can also view the manpage online. -

    - -
    diff --git a/i3lock/index.html b/i3lock/index.html new file mode 100644 index 0000000..046f409 --- /dev/null +++ b/i3lock/index.html @@ -0,0 +1,84 @@ +--- +layout: default +title: i3lock +--- +
    + +

    i3lock

    + +

    + i3lock is a simple screen locker like slock. After starting it, you will see + a white screen (you can configure the color/an image). You can return to your + screen by entering your password. +

    + +

    Improvements

    + +
      +
    • + i3lock forks, so you can combine it with an alias to suspend to RAM (run + "i3lock && echo mem > /sys/power/state" to get a locked screen + after waking up your computer from suspend to RAM) +
    • +
    • + You can specify either a background color or a PNG image which will be + displayed while your screen is locked. +
    • +
    • + You can specify whether i3lock should bell upon a wrong password. +
    • +
    • + i3lock uses PAM and therefore is compatible with LDAP etc. +
    • +
    + + +

    Releases

    + + + +

    Development

    + +

    + i3lock is currently developed at + http://code.i3wm.org/i3lock. Checkouts of the master branch are intended to + be stable and working all the time. Integration of new features happens in a separate branch. +

    + +
    diff --git a/i3lock/index.html.mako b/i3lock/index.html.mako deleted file mode 100644 index e324ea3..0000000 --- a/i3lock/index.html.mako +++ /dev/null @@ -1,84 +0,0 @@ -<%! - section = "i3lock" -%> -<%inherit file="_templates/i3.mako" /> -
    - -

    i3lock

    - -

    - i3lock is a simple screen locker like slock. After starting it, you will see - a white screen (you can configure the color/an image). You can return to your - screen by entering your password. -

    - -

    Improvements

    - -
      -
    • - i3lock forks, so you can combine it with an alias to suspend to RAM (run - "i3lock && echo mem > /sys/power/state" to get a locked screen - after waking up your computer from suspend to RAM) -
    • -
    • - You can specify either a background color or a PNG image which will be - displayed while your screen is locked. -
    • -
    • - You can specify whether i3lock should bell upon a wrong password. -
    • -
    • - i3lock uses PAM and therefore is compatible with LDAP etc. -
    • -
    - - -

    Releases

    - - - -

    Development

    - -

    - i3lock is currently developed at - http://code.i3wm.org/i3lock. Checkouts of the master branch are intended to - be stable and working all the time. Integration of new features happens in a separate branch. -

    - -
    diff --git a/i3status/index.html b/i3status/index.html new file mode 100644 index 0000000..05ea937 --- /dev/null +++ b/i3status/index.html @@ -0,0 +1,76 @@ +--- +layout: default +title: i3status +--- +
    + +

    i3status

    + +

    + i3status is a small program (about 1500 SLOC) for generating a status bar + for i3bar, dzen2, xmobar or similar programs. It is designed to be very + efficient by issuing a very small number of system calls, as one generally + wants to update such a status line every second. This ensures that even under + high load, your status bar is updated correctly. Also, it saves a bit of + energy by not hogging your CPU as much as spawning the corresponding amount + of shell commands would. +

    + +

    Releases

    + + + +

    Documentation

    + +

    + The documentation for i3status is its manpage. You can also view the manpage online. +

    + +

    Development

    + +

    + i3status is currently developed at + http://code.i3wm.org/i3status. Checkouts of the master branch are intended to + be stable and working all the time. +

    + +
    diff --git a/i3status/index.html.mako b/i3status/index.html.mako deleted file mode 100644 index 44d1814..0000000 --- a/i3status/index.html.mako +++ /dev/null @@ -1,76 +0,0 @@ -<%! - section = "i3status" -%> -<%inherit file="_templates/i3.mako" /> -
    - -

    i3status

    - -

    - i3status is a small program (about 1500 SLOC) for generating a status bar - for i3bar, dzen2, xmobar or similar programs. It is designed to be very - efficient by issuing a very small number of system calls, as one generally - wants to update such a status line every second. This ensures that even under - high load, your status bar is updated correctly. Also, it saves a bit of - energy by not hogging your CPU as much as spawning the corresponding amount - of shell commands would. -

    - -

    Releases

    - - - -

    Documentation

    - -

    - The documentation for i3status is its manpage. You can also view the manpage online. -

    - -

    Development

    - -

    - i3status is currently developed at - http://code.i3wm.org/i3status. Checkouts of the master branch are intended to - be stable and working all the time. -

    - -
    diff --git a/impress.html b/impress.html new file mode 100644 index 0000000..82ae020 --- /dev/null +++ b/impress.html @@ -0,0 +1,112 @@ +--- +layout: default +title: impress +--- +
    + +

    Impressum

    + +

    + This website is hosted on a server in germany, so german law demands this: +

    + +

    + Angaben gemäß § 5 TMG: +

    + +
    + Michael Stapelberg
    + Neuer Weg 16
    + 69118 Heidelberg
    +
    + Telefon: +49 6221 1871942
    + E-Mail: michael+impress@stapelberg.de +
    + +

    + Quelle: erstellt mit dem + Impressum-Generator Website von eRecht24. +

    + +

    Haftungsausschluss:

    + +

    Haftung für Inhalte

    + +

    + Die Inhalte unserer Seiten wurden mit größter Sorgfalt erstellt. Für die + Richtigkeit, Vollständigkeit und Aktualität der Inhalte können wir jedoch keine + Gewähr übernehmen. Als Diensteanbieter sind wir gemäß § 7 Abs. 1 TMG für eigene + Inhalte auf diesen Seiten nach den allgemeinen Gesetzen verantwortlich. Nach + §§ 8 bis 10 TMG sind wir als Diensteanbieter jedoch nicht verpflichtet, + übermittelte oder gespeicherte fremde Informationen zu überwachen oder nach + Umständen zu forschen, die auf eine rechtswidrige Tätigkeit hinweisen. + Verpflichtungen zur Entfernung oder Sperrung der Nutzung von Informationen nach + den allgemeinen Gesetzen bleiben hiervon unberührt. Eine diesbezügliche Haftung + ist jedoch erst ab dem Zeitpunkt der Kenntnis einer konkreten Rechtsverletzung + möglich. Bei Bekanntwerden von entsprechenden Rechtsverletzungen werden wir + diese Inhalte umgehend entfernen. +

    + +

    Haftung für Links

    + +

    + Unser Angebot enthält Links zu externen Webseiten Dritter, auf deren Inhalte + wir keinen Einfluss haben. Deshalb können wir für diese fremden Inhalte auch + keine Gewähr übernehmen. Für die Inhalte der verlinkten Seiten ist stets der + jeweilige Anbieter oder Betreiber der Seiten verantwortlich. Die verlinkten + Seiten wurden zum Zeitpunkt der Verlinkung auf mögliche Rechtsverstöße + überprüft. Rechtswidrige Inhalte waren zum Zeitpunkt der Verlinkung nicht + erkennbar. Eine permanente inhaltliche Kontrolle der verlinkten Seiten ist + jedoch ohne konkrete Anhaltspunkte einer Rechtsverletzung nicht zumutbar. Bei + Bekanntwerden von Rechtsverletzungen werden wir derartige Links umgehend + entfernen. +

    + +

    Urheberrecht

    + +

    + Die durch die Seitenbetreiber erstellten Inhalte und Werke auf diesen Seiten + unterliegen dem deutschen Urheberrecht. Die Vervielfältigung, Bearbeitung, + Verbreitung und jede Art der Verwertung außerhalb der Grenzen des + Urheberrechtes bedürfen der schriftlichen Zustimmung des jeweiligen Autors bzw. + Erstellers. Downloads und Kopien dieser Seite sind nur für den privaten, nicht + kommerziellen Gebrauch gestattet. Soweit die Inhalte auf dieser Seite nicht vom + Betreiber erstellt wurden, werden die Urheberrechte Dritter beachtet. + Insbesondere werden Inhalte Dritter als solche gekennzeichnet. Sollten Sie + trotzdem auf eine Urheberrechtsverletzung aufmerksam werden, bitten wir um + einen entsprechenden Hinweis. Bei Bekanntwerden von Rechtsverletzungen werden + wir derartige Inhalte umgehend entfernen. +

    + +

    Datenschutz

    + +

    + Die Nutzung unserer Webseite ist in der Regel ohne Angabe personenbezogener + Daten möglich. Soweit auf unseren Seiten personenbezogene Daten (beispielsweise + Name, Anschrift oder eMail-Adressen) erhoben werden, erfolgt dies, soweit + möglich, stets auf freiwilliger Basis. Diese Daten werden ohne Ihre + ausdrückliche Zustimmung nicht an Dritte weitergegeben. +

    + +

    + Wir weisen darauf hin, dass die Datenübertragung im Internet (z.B. bei der + Kommunikation per E-Mail) Sicherheitslücken aufweisen kann. Ein lückenloser + Schutz der Daten vor dem Zugriff durch Dritte ist nicht möglich. +

    + +

    + Der Nutzung von im Rahmen der Impressumspflicht veröffentlichten Kontaktdaten + durch Dritte zur Übersendung von nicht ausdrücklich angeforderter Werbung und + Informationsmaterialien wird hiermit ausdrücklich widersprochen. Die Betreiber + der Seiten behalten sich ausdrücklich rechtliche Schritte im Falle der + unverlangten Zusendung von Werbeinformationen, etwa durch Spam-Mails, vor. +

    + +

    + Quelle: Disclaimer + von eRecht24, dem Portal zum Internetrecht von Rechtsanwalt + Sören Siebert. +

    + +
    + diff --git a/impress.html.mako b/impress.html.mako deleted file mode 100644 index 5cc1d22..0000000 --- a/impress.html.mako +++ /dev/null @@ -1,112 +0,0 @@ -<%! - section = "impress" -%> -<%inherit file="_templates/i3.mako" /> -
    - -

    Impressum

    - -

    - This website is hosted on a server in germany, so german law demands this: -

    - -

    - Angaben gemäß § 5 TMG: -

    - -
    - Michael Stapelberg
    - Neuer Weg 16
    - 69118 Heidelberg
    -
    - Telefon: +49 6221 1871942
    - E-Mail: michael+impress@stapelberg.de -
    - -

    - Quelle: erstellt mit dem - Impressum-Generator Website von eRecht24. -

    - -

    Haftungsausschluss:

    - -

    Haftung für Inhalte

    - -

    - Die Inhalte unserer Seiten wurden mit größter Sorgfalt erstellt. Für die - Richtigkeit, Vollständigkeit und Aktualität der Inhalte können wir jedoch keine - Gewähr übernehmen. Als Diensteanbieter sind wir gemäß § 7 Abs. 1 TMG für eigene - Inhalte auf diesen Seiten nach den allgemeinen Gesetzen verantwortlich. Nach - §§ 8 bis 10 TMG sind wir als Diensteanbieter jedoch nicht verpflichtet, - übermittelte oder gespeicherte fremde Informationen zu überwachen oder nach - Umständen zu forschen, die auf eine rechtswidrige Tätigkeit hinweisen. - Verpflichtungen zur Entfernung oder Sperrung der Nutzung von Informationen nach - den allgemeinen Gesetzen bleiben hiervon unberührt. Eine diesbezügliche Haftung - ist jedoch erst ab dem Zeitpunkt der Kenntnis einer konkreten Rechtsverletzung - möglich. Bei Bekanntwerden von entsprechenden Rechtsverletzungen werden wir - diese Inhalte umgehend entfernen. -

    - -

    Haftung für Links

    - -

    - Unser Angebot enthält Links zu externen Webseiten Dritter, auf deren Inhalte - wir keinen Einfluss haben. Deshalb können wir für diese fremden Inhalte auch - keine Gewähr übernehmen. Für die Inhalte der verlinkten Seiten ist stets der - jeweilige Anbieter oder Betreiber der Seiten verantwortlich. Die verlinkten - Seiten wurden zum Zeitpunkt der Verlinkung auf mögliche Rechtsverstöße - überprüft. Rechtswidrige Inhalte waren zum Zeitpunkt der Verlinkung nicht - erkennbar. Eine permanente inhaltliche Kontrolle der verlinkten Seiten ist - jedoch ohne konkrete Anhaltspunkte einer Rechtsverletzung nicht zumutbar. Bei - Bekanntwerden von Rechtsverletzungen werden wir derartige Links umgehend - entfernen. -

    - -

    Urheberrecht

    - -

    - Die durch die Seitenbetreiber erstellten Inhalte und Werke auf diesen Seiten - unterliegen dem deutschen Urheberrecht. Die Vervielfältigung, Bearbeitung, - Verbreitung und jede Art der Verwertung außerhalb der Grenzen des - Urheberrechtes bedürfen der schriftlichen Zustimmung des jeweiligen Autors bzw. - Erstellers. Downloads und Kopien dieser Seite sind nur für den privaten, nicht - kommerziellen Gebrauch gestattet. Soweit die Inhalte auf dieser Seite nicht vom - Betreiber erstellt wurden, werden die Urheberrechte Dritter beachtet. - Insbesondere werden Inhalte Dritter als solche gekennzeichnet. Sollten Sie - trotzdem auf eine Urheberrechtsverletzung aufmerksam werden, bitten wir um - einen entsprechenden Hinweis. Bei Bekanntwerden von Rechtsverletzungen werden - wir derartige Inhalte umgehend entfernen. -

    - -

    Datenschutz

    - -

    - Die Nutzung unserer Webseite ist in der Regel ohne Angabe personenbezogener - Daten möglich. Soweit auf unseren Seiten personenbezogene Daten (beispielsweise - Name, Anschrift oder eMail-Adressen) erhoben werden, erfolgt dies, soweit - möglich, stets auf freiwilliger Basis. Diese Daten werden ohne Ihre - ausdrückliche Zustimmung nicht an Dritte weitergegeben. -

    - -

    - Wir weisen darauf hin, dass die Datenübertragung im Internet (z.B. bei der - Kommunikation per E-Mail) Sicherheitslücken aufweisen kann. Ein lückenloser - Schutz der Daten vor dem Zugriff durch Dritte ist nicht möglich. -

    - -

    - Der Nutzung von im Rahmen der Impressumspflicht veröffentlichten Kontaktdaten - durch Dritte zur Übersendung von nicht ausdrücklich angeforderter Werbung und - Informationsmaterialien wird hiermit ausdrücklich widersprochen. Die Betreiber - der Seiten behalten sich ausdrücklich rechtliche Schritte im Falle der - unverlangten Zusendung von Werbeinformationen, etwa durch Spam-Mails, vor. -

    - -

    - Quelle: Disclaimer - von eRecht24, dem Portal zum Internetrecht von Rechtsanwalt - Sören Siebert. -

    - -
    - diff --git a/index.html b/index.html new file mode 100644 index 0000000..d8f9f49 --- /dev/null +++ b/index.html @@ -0,0 +1,96 @@ +--- +layout: default +title: Your New Jekyll Site +--- + +
    + +
    + + i3 screenshot + +
    + +

    Do What I Mean. Good Docs. Clean Code. Sounds good?

    +

    + Then you will love i3. Watch the screencast,
    + read the User’s Guide and install i3! +

    + +
    + +
    +

    +i3 is a tiling +window manager, completely written from scratch. The target platforms are +GNU/Linux and BSD operating systems, our code is Free and Open Source Software +(FOSS) under the BSD license. i3 is primarily targeted at advanced users and +developers. Based upon the experiences we made when wanting to hack/fix wmii, +we agreed upon the following goals for i3: +

    + +
      +
    1. + Write well readable, well documented code. Create additional + documentation on how to extend i3 by explaining its internal workings. +
      + This includes being modifiable by people who do know how to program but who are + not necessarily familiar with all of X11’s internals. That is, document why + things happen and when they happen so that the user gets a picture of the whole + process a Window Manager is responsible of by just reading the source code. +
    2. +
    3. + Use xcb as far as possible (it does not provide functions for some features + yet, like XKB) instead of Xlib. xcb has a much cleaner API and should be faster + in quite a lot of situations. +
    4. +
    5. + Implement multi-monitor correctly, that is by assigning each workspace to a + virtual screen. Especially make sure that attaching and detaching new monitors + like video projectors works during operation and does the right thing. Also + provide support for rotated monitors. +
    6. +
    7. + Use a tree as data structure. This allows for more flexible layouts than + the column-based approach used by other window managers. +
    8. +
    9. + Implement different modes, like in vim. You can use different keybindings + when in the 'resize' mode than when you are in the default mode, for + example. +
    10. +
    11. + Do not use programs such as autoconf/automake for configuration and + creating unreadable/broken makefiles. Instead, use a clean makefile which automatically + enables/disables features for specific platforms. Also, document the dependencies + properly, so that package maintainers have an easy job packaging i3. +
    12. +
    13. + Implement an IPC interface for other programs. Provide subscription to + certain events and accept commands. +
      + This approach should be more lightweight than wmii’s usage of the 9P filesystem. + Furthermore, core functionality does not depend on a separate program, so that i3 + runs faster, especially when your system is under load. +
    14. +
    15. + Be UTF-8 clean. +
    16. +
    17. + The usual elitism amongst minimal window managers: Don’t be bloated, don’t be fancy + (simple borders are the most decoration we want to have). +
      + However, we do not enforce unnecessary limits such as a maximum amount of source lines + of code. If it needs to be a bit bigger, it will be. +
    18. +
    + +
    diff --git a/index.html.mako b/index.html.mako deleted file mode 100644 index 466b214..0000000 --- a/index.html.mako +++ /dev/null @@ -1,95 +0,0 @@ -<%! - section = "index" -%> -<%inherit file="_templates/i3.mako" /> -
    - -
    - - i3 screenshot - -
    - -

    Do What I Mean. Good Docs. Clean Code. Sounds good?

    -

    - Then you will love i3. Watch the screencast,
    - read the User’s Guide and install i3! -

    - -
    - -
    -

    -i3 is a tiling -window manager, completely written from scratch. The target platforms are -GNU/Linux and BSD operating systems, our code is Free and Open Source Software -(FOSS) under the BSD license. i3 is primarily targeted at advanced users and -developers. Based upon the experiences we made when wanting to hack/fix wmii, -we agreed upon the following goals for i3: -

    - -
      -
    1. - Write well readable, well documented code. Create additional - documentation on how to extend i3 by explaining its internal workings. -
      - This includes being modifiable by people who do know how to program but who are - not necessarily familiar with all of X11’s internals. That is, document why - things happen and when they happen so that the user gets a picture of the whole - process a Window Manager is responsible of by just reading the source code. -
    2. -
    3. - Use xcb as far as possible (it does not provide functions for some features - yet, like XKB) instead of Xlib. xcb has a much cleaner API and should be faster - in quite a lot of situations. -
    4. -
    5. - Implement multi-monitor correctly, that is by assigning each workspace to a - virtual screen. Especially make sure that attaching and detaching new monitors - like video projectors works during operation and does the right thing. Also - provide support for rotated monitors. -
    6. -
    7. - Use a tree as data structure. This allows for more flexible layouts than - the column-based approach used by other window managers. -
    8. -
    9. - Implement different modes, like in vim. You can use different keybindings - when in the 'resize' mode than when you are in the default mode, for - example. -
    10. -
    11. - Do not use programs such as autoconf/automake for configuration and - creating unreadable/broken makefiles. Instead, use a clean makefile which automatically - enables/disables features for specific platforms. Also, document the dependencies - properly, so that package maintainers have an easy job packaging i3. -
    12. -
    13. - Implement an IPC interface for other programs. Provide subscription to - certain events and accept commands. -
      - This approach should be more lightweight than wmii’s usage of the 9P filesystem. - Furthermore, core functionality does not depend on a separate program, so that i3 - runs faster, especially when your system is under load. -
    14. -
    15. - Be UTF-8 clean. -
    16. -
    17. - The usual elitism amongst minimal window managers: Don’t be bloated, don’t be fancy - (simple borders are the most decoration we want to have). -
      - However, we do not enforce unnecessary limits such as a maximum amount of source lines - of code. If it needs to be a bit bigger, it will be. -
    18. -
    - -
    diff --git a/screenshots/index.html b/screenshots/index.html new file mode 100644 index 0000000..d321c52 --- /dev/null +++ b/screenshots/index.html @@ -0,0 +1,114 @@ +--- +layout: default +title: Screens +group: Screens +require_jquery: true +javascript: gallery.min.2.js +js_callback: initGallery(); +--- +
    +
    + +
    +
    + +
    +
    +
    +
    +
    +
    +
    +
    + i3-2.png + VIM, MPlayer +
    +
    +
    +
    + +
    + +

    Latest Videos

    + +
    +
    + + Screencast thumbnail + +
    + Screencast of v4.1 +

    + This video (5 min) shows the basic features of i3: +

    +
      +
    • Layouts, Focus, Moving, Workspaces
    • +
    • dmenu, Floating Windows, Resizing
    • +
    +

    + Watch it on YouTube or download it (18 MB). +

    +
    +
    + +
    +
    + +
    + + tech talk thumbnail + +
    + Screencast: Containers and tree data structure +

    Explains how i3 works internally so +that you can fully understand what's going on. I expect you to have +watched the screencast on v4.1 already.

    +

    + Watch it on YouTube +

    +
    +
    + +
    +
    + +
    + + tech talk thumbnail + +
    + Google Tech Talk about i3 +

    This video (1 hour) is an introduction to i3, explaining our +motivation, a bit of history, some cool features and how we +develop.

    +

    + Watch it on YouTube +

    +
    +
    +
    + +

    Screenshots

    + +

    +To get a quick impression of i3, have a look at these screenshots. +

    + +
    +{% include screenshot.html link="/screenshots/i3-1.png" thumb="/screenshots/i3-1.thumb.png" description="Vimperator, VIM, MPlayer, dzen2" %} +{% include screenshot.html link="/screenshots/i3-2.png" thumb="/screenshots/i3-2.thumb.png" description="Vimperator, VIM, xpdf, bc" %} +{% include screenshot.html link="/screenshots/i3-3.png" thumb="/screenshots/i3-3.thumb.png" description="PCManFM, ROXTerm, evince" %} +
    +{% include screenshot.html link="/screenshots/i3-4.png" thumb="/screenshots/i3-4.thumb.png" description="i3 logo out of terminals" %} +{% include screenshot.html link="/screenshots/i3-6.png" thumb="/screenshots/i3-6.thumb.png" description="VIM, zsh, i3status (FreeBSD)" %} +{% include screenshot.html link="/screenshots/i3-7.png" thumb="/screenshots/i3-7.thumb.png" description="GIMP, urxvt (both floating)" %} +
    +{% include screenshot.html link="/screenshots/i3-5.png" thumb="/screenshots/i3-5.thumb.png" description="mc, xosview, MPlayer, irssi, gajim" %} +{% include screenshot.html link="/screenshots/i3-8.jpg" thumb="/screenshots/i3-8.thumb.jpg" description="git, synergy, htop, urxvt" %} +{% include screenshot.html link="/screenshots/i3-9.png" thumb="/screenshots/i3-9.thumb.png" description="VIM, git, MPlayer, i3bar" %} +
    +{% include screenshot.html link="/screenshots/i3-10.png" thumb="/screenshots/i3-10.thumb.png" description="Right-to-left titles" %} +{% include screenshot.html link="/screenshots/i3-11.jpg" thumb="/screenshots/i3-11.thumb.jpg" description="dzen2, VIM, bash, top" %} +
    + +
    diff --git a/screenshots/index.html.mako b/screenshots/index.html.mako deleted file mode 100644 index b8c973c..0000000 --- a/screenshots/index.html.mako +++ /dev/null @@ -1,174 +0,0 @@ -<%! - section = "screens" - javascript = 'gallery.min.2.js' - require_jquery = True - js_callback = 'initGallery();' -%> -<%inherit file="_templates/i3.mako" /> - -
    -
    - -
    -
    - -
    -
    -
    -
    -
    -
    -
    -
    - i3-2.png - VIM, MPlayer -
    -
    -
    -
    - -
    - -

    Latest Videos

    - -
    -
    - - Screencast thumbnail - -
    - Screencast of v4.1 -

    - This video (5 min) shows the basic features of i3: -

    -
      -
    • Layouts, Focus, Moving, Workspaces
    • -
    • dmenu, Floating Windows, Resizing
    • -
    -

    - Watch it on YouTube or download it (18 MB). -

    -
    -
    - -
    -
    - -
    - - tech talk thumbnail - -
    - Screencast: Containers and tree data structure -

    Explains how i3 works internally so -that you can fully understand what's going on. I expect you to have -watched the screencast on v4.1 already.

    -

    - Watch it on YouTube -

    -
    -
    - -
    -
    - -
    - - tech talk thumbnail - -
    - Google Tech Talk about i3 -

    This video (1 hour) is an introduction to i3, explaining our -motivation, a bit of history, some cool features and how we -develop.

    -

    - Watch it on YouTube -

    -
    -
    -
    - -

    Screenshots

    - -

    -To get a quick impression of i3, have a look at these screenshots. -

    - -
    -<% - screens = [ - [ - "/screenshots/i3-1.png", - "/screenshots/i3-1.thumb.png", - "Vimperator, VIM, MPlayer, dzen2" - ], - [ - "/screenshots/i3-2.png", - "/screenshots/i3-2.thumb.png", - "Vimperator, VIM, xpdf, bc" - ], - [ - "/screenshots/i3-3.png", - "/screenshots/i3-3.thumb.png", - "PCManFM, ROXTerm, evince" - ], - [ - "/screenshots/i3-4.png", - "/screenshots/i3-4.thumb.png", - "i3 logo out of terminals" - ], - [ - "/screenshots/i3-6.png", - "/screenshots/i3-6.thumb.png", - "VIM, zsh, i3status (FreeBSD)" - ], - [ - "/screenshots/i3-7.png", - "/screenshots/i3-7.thumb.png", - "GIMP, urxvt (both floating)" - ], - [ - "/screenshots/i3-5.png", - "/screenshots/i3-5.thumb.png", - "mc, xosview, MPlayer, irssi, gajim" - ], - [ - "/screenshots/i3-8.jpg", - "/screenshots/i3-8.thumb.jpg", - "git, synergy, htop, urxvt" - ], - [ - "/screenshots/i3-9.png", - "/screenshots/i3-9.thumb.png", - "VIM, git, MPlayer, i3bar" - ], - [ - "/screenshots/i3-10.png", - "/screenshots/i3-10.thumb.png", - "Right-to-left titles" - ], - [ - "/screenshots/i3-11.jpg", - "/screenshots/i3-11.thumb.jpg", - "dzen2, VIM, bash, top" - ] - ] - - c = 0 -%> -% for link, thumb, description in screens: - -
    - (Screenshot) ${description}
    - ${description} -
    - -<% c += 1 %> -% if (c % 3) == 0: -
    -% endif -% endfor - -
    - -