kick-start /

Filename Size Date modified Message
bin
deps
po
pt_BR
skeleton
src
134 B
153 B
172 B
17.7 KB
2.2 KB
3.9 KB
142 B
2.8 KB
2.8 KB
8.1 KB
28.5 KB
3.8 KB
Mercurial Kick Start by aragost Trifork
=======================================

This is a tutorial for Mercurial based on the principle of
learning-by-doing. The commands and the output you see are "real" in
the sense that the commands are executed when the HTML files are
built. This ensures that the output doesn't go stale when new versions
of Mercurial are released and also that it doesn't go out of sync when
one part of the tutorial is edited without updating another.

Compilation
-----------

You need `Scons`_ to build the tutorial. Run::

  scons en

to build the English version of the tutorial. Run::

  scons

to build all available languages. A cache with the results of the
shell tests will be built in the ``~/.shelltest`` directory. This can
be cleared as needed.

Dependencies
------------

You will need these tools, Debian package names are listed in
parenthesis:

* Python Subversion bindings (python-subversion)
* Docutils (python-docutils)
* Graphviz (graphviz)
* Xvfb (xvfb)
* ImageMagick (imagemagic)
* Python header files (python-dev)
* iniparse (python-iniparse)
* Gettext (gettext)
* PyQt4 (pyqt4-dev-tools)
* Python QScintilla bindings (python-qscintilla2)

The correct versions of Mercurial, TortoiseHg, and hgsubversion is
distributed with the tutorial as subrepos in the ``deps/`` folder.

Translating
-----------

*Translations are very welcome!* The Kick Start is prepared for
translation using standard Gettext ``.po`` files. Start by generating
a ``.pot`` file that you can use as a basis::

  scons pot

This will generate ``po/kick-start.pot`` with all the English source
strings. Now run::

  cd po
  msginit -l xx

to create a ``xx.po`` file for your language. If you don't have
``msginit``, then just copy ``kick-start.pot`` to ``xx.po``. You now
edit ``xx.po`` with a PO editor of your choice.

To back to the top-level and run::

  scons xx

to generate the translation for the ``xx`` language. Please commit
your changes with a ``po-xx:`` prefix in the commit message and submit
a pull request.

License
-------

The Mercurial Kick Start can be distributed according to the terms of
the GNU General Public License version 2 or any later version.

.. _scons: http://www.scons.org/
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.