====================== Crypto 101: the book

.. image:: https://github.com/crypto101/book/actions/workflows/ci.yml/badge.svg?branch=master :target: https://github.com/crypto101/book/actions/workflows/ci.yml?branch=master

This is the source repository for Crypto 101, the introductory book about cryptography by lvh.

.. _Crypto 101: https://www.crypto101.io/ .. _lvh: https://twitter.com/lvh

License

See the LICENSE <LICENSE>_ file.

Translations

For now, crypto101 is only available in english, but you can help translate it into your own language <https://github.com/crypto101/book/issues/372>_.

Building

Run make book in the root directory of the repository to convert the source files into rendered versions of all supported formats.

Dependencies

Due to the high number of dependencies, using docker is highly recommended:

.. code-block:: sh

docker build -t crypto101 docker/ docker run --rm -it -v "$(realpath .)":/repo -u "$(id -u)" crypto101 ./make-lang YOUR_LANGUAGE_CODE html latexpdf epub

YOUR_LANGUAGE_CODE must a valid sphinx language code <https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language>_, like en, fr, ko or zh_CN.

You can find the install procedure for the dependencies for ubuntu <docker/Dockerfile.ubuntu>_ and fedora <docker/Dockerfile.fedora>_ in their dedicated dockerfiles.