added information about planned LaTeX plugin
authorGabriel Pérez-Cerezo <gabriel@gpcf.eu>
Sat, 2 May 2015 21:43:43 +0000 (23:43 +0200)
committerGabriel Pérez-Cerezo <gabriel@gpcf.eu>
Sat, 2 May 2015 21:43:43 +0000 (23:43 +0200)
17 files changed:
2048/index.in.md.de [new file with mode: 0644]
2048/index.in.md.en [new file with mode: 0644]
2048/index.in.md.eo [new file with mode: 0644]
2048/index.in.md.es [new file with mode: 0644]
cms/doc/index.in.md.en [new file with mode: 0644]
cms/index.in.md.de [new file with mode: 0644]
cms/index.in.md.en [new file with mode: 0644]
dwm/index.in.md.de [new file with mode: 0644]
dwm/index.in.md.en [new file with mode: 0644]
dwm/index.in.md.eo [new file with mode: 0644]
index.in.md.de [new file with mode: 0644]
index.in.md.en [new file with mode: 0644]
index.in.md.eo [new file with mode: 0644]
index.in.md.es [new file with mode: 0644]
mail-setup/householderemacs.png [new file with mode: 0644]
mail-setup/index.en.html
mail-setup/index.in.md

diff --git a/2048/index.in.md.de b/2048/index.in.md.de
new file mode 100644 (file)
index 0000000..efdb5cb
--- /dev/null
@@ -0,0 +1,18 @@
+# 2048
+
+Ich habe eine [Version von 2048][orig]
+in C gefunden. Sie funktioniert zwar sehr gut, aber einige Funktionen mehr wären wünschenswert. Also
+habe ich sie erweitert, sodass sie jetzt Highscores speichert und man die Farben des Spielfelds
+verändern kann.
+
+
+Zum installieren muss man `git`, einen C compiler (z.B. `gcc`) und `make` installiert haben. Dann muss man
+nur noch den Befehl
+`git clone git://aubergine.gpcf.eu/2048.git && cd 2048 && sudo make install`
+
+ausführen, um das Spiel zu installieren. Anschließend muss man `2048` eingeben, dann
+erscheint das Spiel. Der Befehl `man 2048` zeigt eine Hilfeseite auf Englisch.
+
+![2048 im Blau-Roten Design](/screenshots/2048.png "2048 unter rxvt-unicode")
+
+[orig]: https://github.com/mevdschee/2048.c
diff --git a/2048/index.in.md.en b/2048/index.in.md.en
new file mode 100644 (file)
index 0000000..4ca94e3
--- /dev/null
@@ -0,0 +1,17 @@
+# 2048
+
+I found a [version of 2048][orig] written in C. It works really well, but it lacks
+some features, such as saving highscores and changing the colours of the board, so I have added them.
+
+
+To install 2048, you need `git`, `make` and a C compiler, like `gcc`. To install 2048, simply
+run the command
+`git clone git://aubergine.gpcf.eu/2048.git && cd 2048 && sudo make install`
+
+in a terminal. When it has been installed, you simply have to run the command `2048`
+to play the game. I have also written a manpage for the game, accessible using the
+command `man 2048`
+
+![2048 with the red and blue color scheme](/screenshots/2048.png "2048 running in rxvt-unicode")
+
+[orig]: https://github.com/mevdschee/2048.c
diff --git a/2048/index.in.md.eo b/2048/index.in.md.eo
new file mode 100644 (file)
index 0000000..4236ebe
--- /dev/null
@@ -0,0 +1,15 @@
+# 2048
+
+Mi trovis [version de 2048][orig] kiu estas skribita en C. Ĝi funcias bone, sed ĝi mankas funkciojn. Do
+mi ĝi plivastigas. Ĝi nun konservi la poentaron kaj vi povas modifi la kolorojn de la ludo. 
+
+
+Por instali 2048 vi devas instali `git`, `gcc` kaj `make`. Tiam vi devas fari la komandon 
+`git clone git://aubergine.gpcf.eu/2048.git && cd 2048 && sudo make install`
+
+por elŝuti la ludon. La komando `man 2048` mostras helppaĝon. Faru la komandon `2048` por
+ludi la ludon.
+
+![2048](/screenshots/2048.png "2048")
+
+[orig]: https://github.com/mevdschee/2048.c
diff --git a/2048/index.in.md.es b/2048/index.in.md.es
new file mode 100644 (file)
index 0000000..0d5a376
--- /dev/null
@@ -0,0 +1,17 @@
+# 2048
+
+He encontrado [versión de 2048][orig] escrita en C, que funciona muy bien,
+pero le faltan funciones. Entonces la he mejorado. Ahora ella guarda la puntuación y se puede
+cambiar el color del tablero.
+
+
+Para instalar 2048 hace falta tener los programas `git`, `make` y `gcc` instalados.
+Para descargar 2048, hay que ejecutar la orden
+`git clone git://aubergine.gpcf.eu/2048.git && cd 2048 && sudo make install`
+
+. Una vez descargado, se puede jugar escribiendo la orden `2048`. Para obtener ayuda,
+se puede ver la página de ayuda usando la orden `man 2048`.
+
+![2048 con el diseño azul y rojo](/screenshots/2048.png "2048 en rxvt-unicode")
+
+[orig]: https://github.com/mevdschee/2048.c
diff --git a/cms/doc/index.in.md.en b/cms/doc/index.in.md.en
new file mode 100644 (file)
index 0000000..08c0d98
--- /dev/null
@@ -0,0 +1,219 @@
+
+
+# Documentation
+
+### Installation
+
+*The front-end (`schreib` command) still needs to be implemented*  
+First, you need to install the `schreib` command, running `git clone
+git://git.gpcf.eu/schreib.git && cd schreib && make install`. To
+create a side, run `schreib new_website directory`, where `directory`
+is the directory in which you want to have the website. `schreib`
+then guides you through the process. 
+
+### Adding pages
+
+To add a page to the site, run `schreib new_page page`, where page is
+the path where the page should be created. For example, if I want to
+create a page about the [GNU](http://gnu.org) operating system, I
+would run `schreib new_page gnu`. This command creates a directory
+called `gnu` and then creates a file called `index.in.md` inside it.
+You can edit that file in your favourite text editor.
+
+### Multilingual files
+
+Schreibblockade includes a system called dislines, implemented in
+`awk` based on the [original implementation][disl] in `perl`. Dislines
+separates a file into several files, depending on how the lines are
+tagged, for example if a line is in English you should write
+
+       @en This line is in English
+
+to write `This line is in English` to the file that contains English
+text.
+
+The `@` has to be the first character in a line, otherwise it will not
+be recognized as a language tag. If you have several lines in the same
+language, you can mark blocks. Blocks start with `@[tag]{` and end
+with `@}`. Blocks cannot be nested. For example, you could also write:
+
+       @en{
+       This line is in English.
+       This line is also in English.
+       @}
+
+You can also say that a line or a block is in several languages, separating
+the tags with a comma:
+
+       @en,de{
+       This strange paragraph is in English and German
+       @}
+       @en,de This line is also strange.
+
+You may not separate the tags with spaces or include spaces before the
+bracket. For example,
+
+       @en, de {
+       foo
+       @}
+       @ en This line is a test
+       @en,de {
+       another line
+       @ }
+all do not produce the desired effect.
+
+Lines without a tag are common to all languages, but the
+file must contain at least one tag. Here is an example:
+
+       @en{
+       Run the following command to see a cow:
+       @}
+       @de Führen Sie folgenden Befehl aus, um eine Kuh zu sehen:
+            apt-get moo
+
+This would create two files: one for English, one for German. The
+English file would contain:
+
+       Run the following command to see a cow:
+               apt-get moo
+
+The contents of the german file would be:
+
+       Führen Sie folgenden Befehl aus, um eine Kuh zu sehen:
+               apt-get moo
+
+You can use [markdown][markdown] (or any other system, just edit the `gen.sh`
+script!) to format the page. You can browse the [git repository][git]
+for my website to get some ideas.
+
+You can use `@"` (with any number of `"`s) to repeat a tag. For
+example the code
+
+       @en Emacs is a great editor
+       @" it is used to edit this site
+
+it is equivalent to
+
+       @en Emacs is a great editor
+       @en it is used to edit this site
+       
+The repetition syntax cannot be used for blocks.
+
+A line starting with `@-` that is not inside a block will be
+discarded. You can use any number of `@`s or `-`s.
+
+If you want to write a `@` at the beginning of a line, you
+should either put a space in front of it or if you are
+not inside a block, you can put a `@` followed by a space.
+For example,
+
+       @ @en English
+
+becomes
+
+       @en English
+
+If there are any spaces before the `@`, you do not have to do
+anything.
+
+In all the commands listed above, you can write any number of `@`s.
+Of course, you can edit the source code of the `dislines.awk` script
+to make it fit your purposes.
+
+### Templates
+
+The content management system uses the template system from
+[werc][werc].
+
+All lines in a page that start with `%%` will be executed by a shell.
+For example,
+
+       %% ls
+
+becomes
+
+       dir1
+       dir2
+       dir3
+       dir4
+       dir5
+       ...
+
+The `%` always has to be at the beginning of the line. As with the
+language tags, you can also use blocks. The blocks start with `%{`
+and end with `%}`.
+
+You can include a variable writing `%($var%)`. For example
+
+       My home directory is %($HOME%).
+
+would expand to
+
+       My home directory is /home/gpcf.
+
+To escape a `%`, simply write `%%`.
+
+*Please note that you can use any shell expression in the this lines,
+so it could be a security risk if everyone could write templates.*
+
+### Markdown
+
+After being processed by `dislines` and `gpp`, the files are processed
+by `markdown`. I recommend to use the [discount][] markdown parser
+because it is much faster than the original `perl` implementation. If
+you want to have more features, I recommend [pandoc][] (also faster
+than the `perl` implementation.
+
+
+### Generating the site
+
+Run the command `schreib make` inside the website's directory. If
+you have made changes to the scripts or to the template, you need
+to force it to regenerate the entire site using `schreib make -f`.
+
+Use `schreib install` to generate the site and send it to a server.
+You need to have `git` installed to do this. `git push` should
+send it to your server and install the site. You should have
+a repository on your server (probably a bare one). Go into the
+directory of the repository and edit the `hooks/post-receive` file.
+It should look like this:
+
+```bash
+#!/bin/sh
+export GIT_WORK_TREE=path/to/your/website
+git checkout -f
+cd \$GIT_WORK_TREE
+rm gen.sh template.awk lib.sh dislines.awk #remove unwanted files
+```
+
+### Web server configuration
+
+The script generates several files from every `index.in.md` file it
+found. If, for instance, a website is in German, English, Esperanto
+and Spanish (like this one), a `index.in.md` file that contains text
+in every one of these languages, is transformed into `index.de.html`,
+`index.es.html`, `index.eo.html` and `index.en.html`. You need to set
+the index pages in your webserver to display the right language. In
+`lighttpd`, which powers this website, if you add something like this
+to `/etc/lighttpd/lighttpd.conf`,
+
+       server.document-root = "/path/to/your/website"
+       $HTTP["host"] == "en.$YOURDOMAIN" {
+               index-file.names = ( "index.en.html" )
+       }
+       $HTTP["host"] == "es.$YOURDOMAIN" {
+               index-file.names = ( "index.es.html" )
+       }
+
+if you access `en.$YOURDOMAIN`, you see the English version of your
+site, and if you access `es.$YOURDOMAIN` you should see the Spanish
+version. Note that you always access the same directory, so it is very
+easy to include common content (e.g. images, stylesheets) without
+wasting disk space on redundant files.
+
+
+[git]: http://git.gpcf.eu/gpcf.eu.git
+[markdown]: http://daringfireball.net/projects/markdown
+[werc-temp]: http://werc.cat-v.org/docs/rc-template-lang
+[disl]: http://www.danielclemente.com/dislines/
+[discount]: http://www.pell.portland.or.us/~orc/Code/discount/
diff --git a/cms/index.in.md.de b/cms/index.in.md.de
new file mode 100644 (file)
index 0000000..8ff12c4
--- /dev/null
@@ -0,0 +1,20 @@
+
+# Schreibblockade
+
+
+Schreibblockade ist ein Content Management System, das gut mit mehrsprachigen
+Seiten umgehen kann.
+
+## Funktionen
+
+* Einfaches mehrsprachiges Dateiformat
+* Seiten in jedem Texteditor bearbeitbar
+* Extrem funktionsreiche Vorlagensprache (Kopiert von [werc](http://werc.cat-v.org))
+* Generiert Statische Seiten
+* Einfach - Weniger als 200 Zeilen `bash`, weniger als 120 Zeilen `awk`
+* Anpassungsfähig
+* Freie Software, steht unter der MIT-Lizenz.
+
+Schreibblockade ist ein unfertiges Projekt. 
+
+[doc]: /cms/doc/
diff --git a/cms/index.in.md.en b/cms/index.in.md.en
new file mode 100644 (file)
index 0000000..576119f
--- /dev/null
@@ -0,0 +1,19 @@
+
+# Schreibblockade
+
+
+## Features
+
+* Write your pages in markdown
+* Convenient multilingual file format
+* Write your own templates as shell scripts (Copied from [werc](http://werc.cat-v.org))
+* Generates static pages for maximum security and performance
+* Database-free
+* Simplicity - Less than 200 lines of `bash`, less than 120 lines of `awk`
+* Can integrate perfectly with other systems or static files.
+* Free Software, licensed under the MIT license.
+
+Schreibblockade is still a project in development and far from being
+finished. Not everything referenced in the [documentation][doc] exists.
+
+[doc]: /cms/doc/
diff --git a/dwm/index.in.md.de b/dwm/index.in.md.de
new file mode 100644 (file)
index 0000000..2e367f3
--- /dev/null
@@ -0,0 +1,28 @@
+# dwm
+
+[dwm][dwm] ist ein kleiner Window-Manager für X11,
+der extrem simpel, schnell und stabil ist. Leider machen seine Standard-Tastenkombinationen 
+die Nutzung von Emacs unmöglich (dwm wurde höchstwahrscheinlich von Vi-Nutzern geschrieben), 
+also habe ich dwm umkonfiguriert. Alle Befehle, die früher die Meta-Taste verwendet haben,
+nutzen in meiner Version die Windows-Taste (auch unter dem Namen Super-Taste bekannt).
+
+
+Meine Version von dwm kann mit dem Befehl
+`git clone git://aubergine.gpcf.eu/dwm.git`
+
+heruntergeladen werden. 
+
+
+Meine Version enthält veränderte Tastenkombinationen, einige für mich nützliche 
+Regeln sowie eine Manpage, die die Tastenkombinationen nahezu vollständig 
+dokumentiert. Vorraussetzungen für die Nutzung von dwm sind Grundkenntnisse in C und im Umgang 
+mit Programmierwerkzeugen wie `make`, da ich dwm nur als Quellcode verbreite und man
+dwm neu kompilieren muss, wenn man die Konfiguration ändert. 
+
+Hier ein Screenshot von Emacs unter dwm:
+
+![Emacs unter dwm](/screenshots/emacs_dwm_600.png "Emacs unter dwm")
+
+[dwm]: http://dwm.suckless.org
+[tar]: /dowmloads/dwm_src.tar.bz2
+[sig]: /downloads/dwm_src.tar.bz2.sig
diff --git a/dwm/index.in.md.en b/dwm/index.in.md.en
new file mode 100644 (file)
index 0000000..d2f9317
--- /dev/null
@@ -0,0 +1,27 @@
+# dwm
+
+[dwm][dwm] is a simple, fast, stable and lightweight window
+manager for X11, but its keyboard shortcuts make it impossible to use
+Emacs (dwm was probably written by vi users), so I have reconfigured
+dwm. All shortcuts that used the Meta key, now use the Windows key
+(also known as super key).
+
+
+You can run the command
+`git clone git://aubergine.gpcf.eu/dwm.git`
+
+to download my version of dwm. 
+
+
+My version also contains some useful rules and keyboard shortcuts and a better
+manpage, that documents almost all keyboard shortcuts. To use dwm you need to know
+at least the basics of C programming and basic usage of tools like `make`, because
+you have to recompile dwm to change the configuration.
+
+Here is a screenshot of dwm:
+
+![dwm](/screenshots/emacs_dwm_600.png "Emacs")
+
+[dwm]: http://dwm.suckless.org
+[tar]: /dowmloads/dwm_src.tar.bz2
+[sig]: /downloads/dwm_src.tar.bz2.sig
diff --git a/dwm/index.in.md.eo b/dwm/index.in.md.eo
new file mode 100644 (file)
index 0000000..28bd244
--- /dev/null
@@ -0,0 +1,18 @@
+# dwm
+
+[dwm][dwm] estis malgranda fenestrodministrilo por la fenestra
+sistemo X. Ĝia klavarkombinoj malfaciligas la utiligo de Emacs. Mi
+rekonfiguris dwm. Ĉio klavarkombinoj kia utiligis la metaklavon nun
+utiligas la Windowsklavon.
+
+Vi povas fari la komandon
+`git clone git://aubergine.gpcf.eu/dwm.git`
+
+por elŝuti dwm. 
+
+
+
+
+[dwm]: http://dwm.suckless.org
+[tar]: /dowmloads/dwm_src.tar.bz2
+[sig]: /downloads/dwm_src.tar.bz2.sig
diff --git a/index.in.md.de b/index.in.md.de
new file mode 100644 (file)
index 0000000..2eb7700
--- /dev/null
@@ -0,0 +1,13 @@
+
+# gpcf.eu
+
+Man kann auf diese Seite auch über [https](https://de.gpcf.eu)
+mithilfe von [Monkeysphere][msph] zugreifen.
+
+Hier ist eine [Anleitung][], die zeigt, wie man GnuPG benutzt, um
+seine E-Mails vor der NSA zu schützen.
+
+[Anleitung]: https://emailselfdefense.fsf.org/de/
+[dwm]:/dwm
+[2048]:/2048
+[msph]:http://web.monkeysphere.info
diff --git a/index.in.md.en b/index.in.md.en
new file mode 100644 (file)
index 0000000..d68e834
--- /dev/null
@@ -0,0 +1,11 @@
+
+# gpcf.eu
+
+You can also access this site over [https](https://en.gpcf.eu) using
+[Monkeysphere][msph]
+
+
+[Anleitung]: https://emailselfdefense.fsf.org/de/
+[dwm]:/dwm
+[2048]:/2048
+[msph]:http://web.monkeysphere.info
diff --git a/index.in.md.eo b/index.in.md.eo
new file mode 100644 (file)
index 0000000..735aa8d
--- /dev/null
@@ -0,0 +1,9 @@
+
+# gpcf.eu
+
+
+
+[Anleitung]: https://emailselfdefense.fsf.org/de/
+[dwm]:/dwm
+[2048]:/2048
+[msph]:http://web.monkeysphere.info
diff --git a/index.in.md.es b/index.in.md.es
new file mode 100644 (file)
index 0000000..f513b79
--- /dev/null
@@ -0,0 +1,11 @@
+
+# gpcf.eu
+
+También se puede acceder a este sitio a través de [https](https://es.gpcf.eu),
+usando [Monkeysphere][msph].
+
+
+[Anleitung]: https://emailselfdefense.fsf.org/de/
+[dwm]:/dwm
+[2048]:/2048
+[msph]:http://web.monkeysphere.info
diff --git a/mail-setup/householderemacs.png b/mail-setup/householderemacs.png
new file mode 100644 (file)
index 0000000..c7aa493
Binary files /dev/null and b/mail-setup/householderemacs.png differ
index 9c8600c..1bc15b7 100644 (file)
@@ -29,6 +29,10 @@ My mail setup with Wanderlust
 <p>I used to have a custom function to decrypt PGP/MIME messages, but I found out that you can add</p>
 <pre class="sourceCode commonlisp"><code class="sourceCode commonlisp">(<span class="kw">setq</span> mime-pgp-decrypt-when-preview <span class="kw">t</span>)</code></pre>
 <p>to your <code>.emacs</code> file to decrypt the messages automatically when you select them from the <code>Summary</code> buffer.</p>
+<p>I am working on a module that shows equations in E-Mail messages using <code>LaTeX</code>. Here is a screenshot of it in action:</p>
+<div class="figure">
+<img src="householderemacs.png" alt="Emacs showing math" /><p class="caption">Emacs showing math</p>
+</div>
 <p>You can also see my entire <a href="http://git.gpcf.eu/?p=dotfiles.git;a=blob;f=.wl">.wl file</a></p>
   <footer>
 <!--    <a href="//gnu.org/software/emacs" >
index 606c4c2..0776445 100644 (file)
@@ -54,6 +54,14 @@ to your `.emacs` file to decrypt the messages automatically when you select
 them from the `Summary` buffer.
 @}
 
+@en{
+I am working on a module that shows equations in E-Mail messages using `LaTeX`.
+Here is a screenshot of it in action:
+
+![Emacs showing math](householderemacs.png)
+@}
+
+
 @en You can also see my entire [.wl file][dotwl]
 @de Du kannst auch meine gesamte [Konfigurationsdatei für Wanderlust][dotwl] lesen.