]> git.sur5r.net Git - i3/i3.github.io/blob - docs/index.html.mako
fba865e62e94392512a752b7ceb6971f61736b25
[i3/i3.github.io] / docs / index.html.mako
1 <%!
2         section = "docs"
3 %>
4 <%inherit file="_templates/i3.mako" />
5 <div id="content">
6 <h2>Documentation for i3 v4.8</h2>
7
8 <p>
9 One of i3’s goals is good documentation. The documents which you will find
10 below will hopefully answer all your questions. If you have any corrections or
11 suggestions please let us know!
12 </p>
13
14 <div class="docs">
15 <h2>For users</h2>
16
17 <p style="font-size: 100%; background-color: #444; border-radius: 5px; padding: 0.5em; width: 90%">
18 <a href="/docs/userguide.html" style="font-size: 125%"><strong>User’s Guide</strong></a><br>
19 Introduction and reference. Read this!
20 </p>
21
22 <p>
23 <a href="/docs/layout-saving.html"><strong>Layout saving/restoring</strong></a><br>
24 Explains how to save a layout and restore it in a new i3 session.
25 </p>
26
27
28 <p>
29 <a href="/docs/multi-monitor.html"><strong>Multi-monitor</strong></a><br>
30 Interesting for users of the nVidia driver.
31 </p>
32
33 <p>
34 <a href="/docs/debugging.html"><strong>Debugging i3</strong></a><br>
35 Explains you how to enable debug logging.
36 </p>
37
38 <p>
39 <a href="/docs/wsbar.html"><strong>External workspace bars</strong></a><br>
40 About bar programs such as i3bar or dzen2.
41 </p>
42
43 <p>
44 <a href="/docs/refcard.html"><strong>i3 reference card</strong></a><br>
45 Might be useful to memorize i3’s shortcuts.
46 </p>
47 </div>
48
49 <div class="docs">
50 <h2>For developers</h2>
51
52 <p style="padding-top: 1em">
53 <a href="/docs/hacking-howto.html"><strong>Hacking Howto</strong></a><br>
54 Helps you if you want to get into i3’s source code.
55 </p>
56
57 <p>
58 <a href="/docs/debugging.html"><strong>Debugging i3</strong></a><br>
59 Explains you how to enable debug logging.
60 </p>
61
62 <p>
63 <a href="/docs/ipc.html"><strong>Inter process communication (IPC interface)</strong></a><br>
64 Read this if you want to talk to i3 within your script.
65 </p>
66
67 <p>
68 <a href="/docs/testsuite.html"><strong>i3 testsuite</strong></a><br>
69 Makes you able to read and write i3 testcases.
70 </p>
71
72 <p>
73 <a href="/docs/i3bar-protocol.html"><strong>i3bar protocol</strong></a><br>
74 Documents the JSON based protocol which i3bar uses.
75 </p>
76
77 </div>
78
79 <br style="clear: both">
80
81 <h2>User-contributed articles</h2>
82
83 <div class="ugdocs">
84
85 <p>
86 <a href="/docs/buildbot.html"><strong>i3 buildbot setup</strong></a> <span class="author">(2012-09, by Michael)</span><br>
87 Describes the <a href="http://www.buildbot.net/">buildbot</a> setup i3 uses for
88 automatic docs, compilation and debian packages.
89 </p>
90
91 <p>
92 <a href="/docs/user-contributed/lzap-config.html"><strong>Lukáš Zapletal’s i3
93 configuration</strong></a> <span class="author">(2012-08, by Lukáš)</span><br>
94 A detailed explanation of Lukáš’s configuration of i3 and related tools.
95 </p>
96
97 <p>
98 <a href="/docs/user-contributed/swapping-workspaces.html"><strong>Swapping
99 workspaces</strong></a> <span class="author">(2012-09, by Sagar)</span><br>
100 Shows how Sagar uses i3’s IPC interface to swap workspaces between two outputs.
101 </p>
102
103 <p>
104 <a href="/docs/user-contributed/conky-i3bar.html"><strong>Using conky with
105 i3bar</strong></a> <span class="author">(2012-11, by Gianrico)</span><br>
106 Shows how to configure conky to generate JSON input for i3bar (with colors)!
107 </p>
108
109 <p>
110 <a href="/docs/user-contributed/py3status.html"><strong>Enhanced and extensible
111 i3bar with py3status</strong></a> <span class="author">(2013-02, by Ultrabug)</span><br>
112 Introduces py3status, a wrapper script for i3status which is easily extensible.
113 </p>
114
115 <p>
116 <a href="/docs/tshirts.html"><strong>i3wm T-shirts</strong></a>
117 <span class="author">(2013-12, by Stefan)</span><br>
118 Where and how to order official i3 T-shirts.
119 </p>
120
121
122 </div>
123
124 </div>