From 41d034a6db2485a27432bc4b066e49a6b5a22a57 Mon Sep 17 00:00:00 2001 From: Michael Stapelberg Date: Thu, 12 Apr 2012 16:01:10 +0200 Subject: [PATCH] replace the refcard with an HTML version (by SardemFF7) This eliminates our build-depedency on latex. --- .gitignore | 3 - debian/control | 2 +- debian/i3-wm.docs | 3 + docs/Makefile | 9 +-- docs/logo-30.png | Bin 0 -> 2751 bytes docs/refcard.html | 186 ++++++++++++++++++++++++++++++++++++++++++++++ docs/refcard.tex | 107 -------------------------- 7 files changed, 194 insertions(+), 116 deletions(-) create mode 100644 docs/logo-30.png create mode 100644 docs/refcard.html delete mode 100644 docs/refcard.tex diff --git a/.gitignore b/.gitignore index b641592b..0aa8aea3 100644 --- a/.gitignore +++ b/.gitignore @@ -33,7 +33,4 @@ i3-nagbar/i3-nagbar i3-msg/i3-msg i3-config-wizard/i3-config-wizard libi3/libi3.a -docs/*.html -docs/*.aux -docs/*.out docs/*.pdf diff --git a/debian/control b/debian/control index 1119d69d..ddbe4fc3 100644 --- a/debian/control +++ b/debian/control @@ -3,7 +3,7 @@ Section: utils Priority: extra Maintainer: Michael Stapelberg DM-Upload-Allowed: yes -Build-Depends: debhelper (>= 7.0.50~), libx11-dev, libxcb-util0-dev (>= 0.3.8), libxcb-keysyms1-dev, libxcb-xinerama0-dev (>= 1.1), libxcb-randr0-dev, libxcb-icccm4-dev, libxcursor-dev, asciidoc (>= 8.4.4), xmlto, docbook-xml, pkg-config, libev-dev, flex, bison, libyajl-dev, texlive-latex-base, texlive-latex-recommended, texlive-latex-extra, libpcre3-dev, libstartup-notification0-dev (>= 0.10) +Build-Depends: debhelper (>= 7.0.50~), libx11-dev, libxcb-util0-dev (>= 0.3.8), libxcb-keysyms1-dev, libxcb-xinerama0-dev (>= 1.1), libxcb-randr0-dev, libxcb-icccm4-dev, libxcursor-dev, asciidoc (>= 8.4.4), xmlto, docbook-xml, pkg-config, libev-dev, flex, bison, libyajl-dev, libpcre3-dev, libstartup-notification0-dev (>= 0.10) Standards-Version: 3.9.2 Homepage: http://i3wm.org/ diff --git a/debian/i3-wm.docs b/debian/i3-wm.docs index 9f7ed2c6..a14b8152 100644 --- a/debian/i3-wm.docs +++ b/debian/i3-wm.docs @@ -25,3 +25,6 @@ docs/tree-shot1.png docs/tree-shot2.png docs/tree-shot3.png docs/tree-shot4.png +docs/refcard.html +docs/refcard_style.css +docs/logo-30.png diff --git a/docs/Makefile b/docs/Makefile index 6584ac06..fc41236f 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -1,7 +1,9 @@ # To pass additional parameters for asciidoc ASCIIDOC=asciidoc -all: hacking-howto.html debugging.html debugging-release-version.html userguide.html ipc.html multi-monitor.html wsbar.html refcard.pdf testsuite.html i3bar-protocol.html +ASCIIDOC_TARGETS:=hacking-howto.html debugging.html debugging-release-version.html userguide.html ipc.html multi-monitor.html wsbar.html testsuite.html i3bar-protocol.html + +all: ${ASCIIDOC_TARGETS} hacking-howto.html: hacking-howto $(ASCIIDOC) -a toc -n $< @@ -30,8 +32,5 @@ multi-monitor.html: multi-monitor wsbar.html: wsbar $(ASCIIDOC) -a toc -n $< -refcard.pdf: refcard.tex - pdflatex refcard.tex && pdflatex refcard.tex - clean: - find . -regex ".*\.\(aux\|out\|log\|toc\|bm\|pdf\|dvi\|log\|html\)" -exec rm '{}' \; + rm -f ${ASCIIDOC_TARGETS} diff --git a/docs/logo-30.png b/docs/logo-30.png new file mode 100644 index 0000000000000000000000000000000000000000..207b88886036187b6db78f551d49099f5309cff2 GIT binary patch literal 2751 zcmV;w3PAOVP)00001b5ch_0Itp) z=>PxYT6^#B{(a}1nKM_&q?p6i+W zxu5Ubdo3Q017g4I{r1~?t-tpEZ5(~@*B88Gr~nZFA^{`;1OY$+MEL&$fo+e(6{NkG z5g3IXGBW}@0%j6s1ZEPk3fK`iN5V|vtOB-5*b!T+w223MUN&3^hyW=DBtawrL`DPz zKmh>ha}hZ2XmJIJiS7P=9Xz8b4vhlm2-uPQFU%=nOTt!xbqd&$SgXY5TG+A{L=hqe z07fD~BnHGgCr3cQI~C}IQ7J53!2^+^7eD#f@Z8O{?)i&L`&w%PA_67?Bm#$whzbxz z09hO=5D)|qaL5`-IaJyLfFKbgDgpXGI3nJG0w9tQf^6?M<&U2`J@w^Zd0>2HV>kcG z*Z-}3<@R1H34O!PAt_hjqySe?#fBM0V@BRGt)<`)qw#XGCiI8(bq<~1kDFI7L z0}+E#4iFhhF)GDK;-knI4WdYBl%9e_!44 z!-&0Ppa1|+T1!Vv@6Fkzox{~2nI5ZTzGvw4(aFmE@br-+FJ$?tbB+(dn0-nVG5WHe1(s>|Pv&fQaIG9`q>4 z&tJN=dEaPUni?);foJI9nel;ZOY8OP8?8nd27~}0fS}4p9(&%zl>!xs6|!6PPVPY2 zFbo6|)q^b8cz# z$Z(WR4rN*38G2;qz~JTi)&0fYycq@_5qW`%L}!w3k&t_PHu(j?c5fQ82~U2jk1oxH=2x6u+w%$z2^#2nn@`sClT&J-1wtc z-v06R_4+!3(0C;&{l&9KpEz3T4z4#{%aY$~JL-V(^NV}I+BeQ!eHTQKS>Wiwp`=ys zbxC`La-%1IrwviJm9u?kVQY7FvtEDYC-XPnT5N634Et%QSYO|sF3 zzJ9HK?PJsNST*&ta^!~(9n40~&n++gVoTKuP_EH)MWgnSlUsw@cl>eSP8DfBbCy*6G9P;NL(0;3vNE#p6$%s@l;T^P7#G9`?3c zwyQnO^S$A{Fd=kNQ}iJ|Vup4DxjTz&e1iF=)M3{^z z<5QL$bC`y()=76R++1CJbSjvrM5glAt-ZO~oz3>&eD2t%LQe;UWB2v%-#CA(`+ z8vsG251f1fgRDS8K_UiJB8U=r2KJrbId}2)>ce-H2d1i7DfG1W$l>zj+{)Jad%NLU zl*WLFl4K#y7p0vGOZE3JEbPwy=<-tSAHHs0h^?vm2Mbc7Fe7VX1@$MS%z^ zJ$~W^^fLRNsA#aCDUJ&%Sup#m+!2m+w=*!^EYKec_e z>6-^436c^)kkI#WqpO;4TwY#&_)s=5RZYuDV4^4P$_~wMu5Vwtv9s%JQ$I7-ocNQE z;!|J!#N=lOV{bqas#{yl<>$V=^sVb|tX7GXVdto?je_W%c zK;!3VyaKduwIAlY9cWD^z4TizJn+o%gVh7pvD<8P_ph!umVBet;lXfhv>a6(vqJ#9 zy3xA!2d{1X>)Vad^=bmK6dfZ)&x0a2T=a}mqaS(+{lp^y#oCx7u$typ4%KMdlOYmk4 + + + + i3 Reference Card + + + + +
+
+ +

i3 Reference Card

+ http://i3wm.org/docs/userguide.html +

+ Throughout this guide, the i3 logo will be used to refer to the configured modifier. + This is the key (Mod1) by default, + with super/ (Mod4) being a popular alternative. +

+
+ +
+

Basics

+ + + + + + +
+ + open new terminal + +
+j + focus left + +
+k + focus down + +
+l + focus up + +
+; + focus right +
+
+ + +
+

Changing the container layout

+ + + + +
+e + default + +
+s + stacking + +
+w + tabbed +
+
+ +
+ +
+

Fullscreen mode

+ + +
+f + toggle fullscreen +
+
+ + +
+

Opening other applications

+ + +
+d + open application (with dmenu) +
+ + +
+

Closing windows

+ + +
++ q + kill a window +
+
+ + +
+

Using workspaces

+ + +
+19 + switch to another workspace +
+
+ + +
+

Moving windows to workspaces

+ + +
+ + 19 + move a window to another workspace +
+
+ +
+ +
+

Resizing

+

Look at “Resizing containers / windows” section of the user guide.

+
+ + +
+

Restart / Exit

+ + + +
+ + r + restart i3 inplace + +
+ + e + + exit i3 +
+ + +
+

Floating

+ + + +
+ + + toggle floating + +
+ + drag floating +
+
+ + + +

+ Permission is granted to copy, distribute and/or modify this document provided + the copyright notice and this permission notice are preserved on all copies. +

+
+ diff --git a/docs/refcard.tex b/docs/refcard.tex deleted file mode 100644 index 6ded01e9..00000000 --- a/docs/refcard.tex +++ /dev/null @@ -1,107 +0,0 @@ -\documentclass[10pt,a4,landscape]{article} - -% \usepackage[cam,a4,center,info,]{crop} % frame -\usepackage[height=20cm,width=25.7cm,noheadfoot,landscape]{geometry} % A4 - 210297 mm - -\usepackage[T1]{fontenc} -\usepackage{multicol} -\usepackage{color} -\usepackage{url} -\usepackage{lastpage} - -\usepackage{hyperref} -\hypersetup{ - pdftitle={i3 Reference Card}, - pdfauthor={\textcopyright\ Zeus Panchenko}, - pdfkeywords={i3, refcard}, - pdfsubject={based on http://i3wm.org/docs/userguide.html}, - pdfpagemode={FullScreen}} - -\definecolor{lightgray}{gray}{0.7} - -\pagestyle{empty} - -\setlength{\parindent}{0in} -\setlength{\columnseprule}{0.5pt} -\setlength{\columnsep}{20pt} - -\newcommand{\RefCardTitle}[2] -{\centering{\Large{\textbf{i3 Reference Card (#1/#2)\\ - {\scriptsize{\url{http://i3wm.org/docs/userguide.html}}}}}} - \vspace{1mm}} - - -\newcommand{\RefCardSec}[1] {\vspace{2mm} \raggedright {\vspace{0.5mm} - \colorbox{lightgray} {\makebox[0.31\textwidth][l] - {\Large{\textsc{\textsf{\textbf{\color{black}#1}}}}}} - \vspace{0.5mm}}} - -\newcommand{\RefCardRow}[2] {\normalsize{\textbf{\texttt{#1}}} - \hspace{\stretch{1}} \raggedleft{\small{\textnormal{#2}}} \\} - -\begin{document} - -\centering - -\begin{multicols}{3} - \RefCardTitle{\thepage}{\pageref{LastPage}} - - \RefCardSec{Moving around} - - \RefCardRow{Mod1+Enter}{open new terminal} - \RefCardRow{Mod1+j}{focus (left)} - \RefCardRow{Mod1+k}{focus (down)} - \RefCardRow{Mod1+l}{focus (up)} - \RefCardRow{Mod1+;}{focus (right)} - \RefCardRow{Mod1+Shift+j}{move window (left)} - \RefCardRow{Mod1+Shift+k}{move window (down)} - \RefCardRow{Mod1+Shift+l}{move window (up)} - \RefCardRow{Mod1+Shift+;}{move window (right)} - \RefCardRow{Mod1+Control+j}{snap (left)} - \RefCardRow{Mod1+Control+k}{snap (down)} - \RefCardRow{Mod1+Control+l}{snap (up)} - \RefCardRow{Mod1+Control+;}{snap (right)} - \RefCardRow{Mod1+Shift+q}{kill a window} - \RefCardRow{Mod1+Shift+}{move a window to another workspace} - - - \RefCardSec{Changing container modes} - - \RefCardRow{Mod1+e}{default} - \RefCardRow{Mod1+h}{stacking} - \RefCardRow{Mod1+w}{tabbed} - \RefCardRow{Mod1+Shift+f}{global fullscreen} - \RefCardRow{Mod1+f}{toggle fullscreen} - \RefCardRow{Mod1+Shift+Space}{toggle floating} - \RefCardRow{Mod1+}{drag floating} - - \RefCardSec{Opening other applications} - - \RefCardRow{Mod1+v}{open application launcher (dmenu)} - - \RefCardSec{Using workspaces} - - \RefCardRow{Mod1+}{switch to another workspace} - - \RefCardSec{Restarting i3 inplace} - - \RefCardRow{Mod1+Shift+r}{restart i3 inplace} - - \RefCardSec{Exiting i3} - - \RefCardRow{Mod1+Shift+e}{exit i3} - - \vspace{1cm} - \tiny{ - \begin{center} - Copyright \copyright 2009, Michael Stapelberg \\ - All rights reserved. \\ - Designed by Zeus Panchenko - \end{center} - Permission is granted to copy, distribute and/or modify this - document provided the copyright notice and this permission - notice are preserved on all copies.} - -\end{multicols} - -\end{document}