# Debian Reference Card

The 101 most important things when using Debian

## Availability

The source code of this card is available via the Debian Salsa service in DocBook/XML format. You may access the repository via the web interface. Or check out the latest version using this command:

    git clone https://salsa.debian.org/ddp-team/refcard.git

The actual reference card in English, for printing in international paper format is here. For other languages and US letter size, see below.

Language | Print | Title | Last Translator | Status
Bulgarian (bg) | A4 | - |  |
Catalan (ca) | A4 | - |  |
Czech (cs) | A4 | - |  |
Danish (da) | A4 | - |  |
German (de) | A4 | - |  |
Greek (el) | A4 | - |  |
English (en) | A4 Lt | - | n/a | n/a
Spanish (es) | A4 Lt | - |  |
Basque (eu) | A4 | - |  |
Finnish (fi) | A4 | - |  |
French (fr) | A4 Lt | - |  |
Galician (gl) | A4 | - |  |
Hindi (hi) | A4 | - |  |
Hungarian (hu) | A4 | - |  |
Bahasa Indonesia (id) | A4 | - |  |
Italian (it) | A4 | - |  |
Japanese (ja) | A4 | - |  |
Lithuanian (lt) | A4 | - |  |
Malay (ms) | A4 | - |  |
Norwegian Bokmål (nb) | A4 | - |  |
Dutch (nl) | A4 | - |  |
Polish (pl) | A4 | - |  |
Portugese, as spoken in Brazil (pt_BR) | A4 | - |  |
Portugese, as spoken in Portugal (pt) | A4 | - |  |
Romanian (ro) | A4 | - |  |
Russian (ru) | A4 | - |  |
Serbian (sr) | A4 | - |  |
Slovak (sk) | A4 | - |  |
Swedish (sv) | A4 | - |  |
Turkish (tr) | A4 | - |  |
Ukrainian (uk) | A4 | - |  |
Vietnamese (vi) | A4 | - |  |
Chinese, as spoken in China (zh_CN) | A4 | - |  |
Traditional Chinese (zh_TW) | A4 | - |  |

## Print, Fold, and Enjoy

The reference card has been designed for printers that are able to print whole pages, without large margins! On my own private printer (HP Inkjet) or other so-called consumer printers you cannot print the card!

Folding

First, the paper side with the title and the legal notice (copyleft) are on the back. Fold the right third of the paper to the small mark at the upper margin between the left and middle third. Now fold the left third over the right one. The title page should be in the front, the legal notice on the back. If not, try again.

Of course, you may alter the reference card to your needs and create a customised refcard. You need to install the build dependencies with `apt-get build-dep refcard`; these are mostly: `docbook-xsl`, `texlive-extra-utils`, `pdftk`, `po4a`, `dblatex`, `poppler-utils`, and `xsltproc`.

## Help!

If you like to translate the reference card into your language, please contact me first, so that duplicated work is prevented.

If you are going to translate the refcard, make sure to

1. use the file `po4a/entries.pot` as template;

2. check out the latest version from the git repository;

3. do not forget to translate the legal notice;

4. use `UTF-8` as encoding.

Use whatever editor you like, but it must work with UTF-8. A nice editor for translations is `poedit`. If you happen to use Emacs (`emacs24`), try `gettext-el`.

Because other languages might be more verbose than English (and German is more verbose), the translation might not fit on one sheet! Translators need to re-phrase things! The translation does not need to be 100% exact, it's more important, that everything fits on the card!

The reference card has been designed for international paper format (ISO A4) - the US letter format has less space. This applies to English, French, and Spanish.

## Acronyms related to Debian

- English and Vietnamese explanations
- Debian Women Dictionary, useful for everyone

## Thanks

Michael Wiedmann helped a lot with the db2latex-xsl toolchain.

The following people helped by correcting my so-called English, by adding important commands, by advertising the card, by giving valuable hints, or just by motivating me: Adrian Dagurashibanipal von Bidder, Andreas Tille, Chris Walker, Eduard Bloch, Holger Blaschka, Oliver Kurth, Philip Miller, Rahmat M. Samik-Ibrahim, Ralph Aichinger, Ralph Katz, Rob Bradford, Frank Küster, Wouter Verhelst, Justin B Rye for corrections and useful ideas.