This the repository of the new Tor Browser manual maintained with lektor.

The current online version of the manual can be found at
 - https://tb-manual.torproject.org
 - http://dsbqrprgkqqifztta6h3w7i2htjhnq7d3qkh3c7gvc35e66rrcv66did.onion/

To clone the code use either one of these options:

* Local git:
  - `git clone https://gitweb.torproject.org/project/web/manual.git`
  - `torify git clone http://xtlfhaspqtkeeqxk6umggfbr3gyfznvf4jhrge2fujz53433i2fcs3id.onion/project/web/manual.git`

* Browse the online git:
  - http://gzgme7ov25seqjbphab4fkcph3jkobfwwpivt5kzbv3kqx2y2qttl4yd.onion/project/web/manual.git

How to report bugs or feedback
==============================

First, check if the bug is already known. You can search and read all the issues at https://gitlab.torproject.org/. To create a new issue, please [request a new account](https://gitlab.onionize.space/) to access Tor Project's GitLab instance and [find the right repository](https://gitlab.torproject.org/tpo) to report your issue. Issues related to our websites should be filed under the [Web issue tracker](https://gitlab.torproject.org/groups/tpo/web/-/issues).

What is Lektor?
===============

[Lektor](https://www.getlektor.com) is a framework to generate and serve
websites from Markdown files. For an intro to manage files see #24275.

Its code can be found at https://github.com/lektor/lektor

Update translation
------------------

To translate the Tor Browser Manual, please join the Tor Project team in Transifex. Learn how you can [become a Tor translator](https://community.torproject.org/localization/becoming-tor-translator/).
The transifex link is: https://www.transifex.com/otf/tor-project-support-community-portal/tbmanual-contentspot/

The translation statistics for this website can be seen at https://torpat.ch/manual-locales (courtesy of [arthuredelstein](https://github.com/arthuredelstein/))

Translations are managed with the i18n plugin:
https://github.com/numericube/lektor-i18n-plugin

To add new languages see [Add new languages to support portal documentation](https://trac.torproject.org/projects/tor/wiki/org/operations/services/support#Addanewlanguagetothesupportportal) | or via [Onion Services](http://ea5faa5po25cf7fb.onion/projects/tor/wiki/org/operations/services/support#Addanewlanguagetothesupportportal).


Generate screenshots
------------------

This is currently work in progress, see [#28235](https://trac.torproject.org/projects/tor/ticket/28235).
