mirror of https://github.com/zulip/zulip.git
f9bbc5d6ff
This supports i18n using all of the following: - I18N urls - Session - Cookie - HTTP header |
||
|---|---|---|
| .. | ||
| _static | ||
| .gitignore | ||
| Makefile | ||
| README.md | ||
| changelog.md | ||
| code-style.rst | ||
| conf.py | ||
| directory-structure.rst | ||
| front-end-build-process.rst | ||
| html_unescape.py | ||
| index.rst | ||
| integration-guide.md | ||
| markdown.md | ||
| mypy.md | ||
| new-feature-tutorial.rst | ||
| queuing.md | ||
| requirements.readthedocs.txt | ||
| roadmap.md | ||
| schema-migrations.md | ||
| testing.rst | ||
| translating.md | ||
README.md
These docs are written in rST, and are included on the zulip.org website as well as on each development installation. Many of these docs have been ported from the internal docs of Zulip Inc., and may need to be updated for use in the open source project.
To generate HTML docs locally from rST:
pip install sphinx- In this directory,
make html. Output appears in a_build/htmlsubdirectory.
To create rST from MediaWiki input:
- Use
pandoc -r mediawiki -w rston MediaWiki source. - Use unescape.py to remove any leftover HTML entities (often inside
tags and the like).
We can use pandoc to translate mediawiki into reStructuredText, but some things need fixing up:
- Add page titles.
- Review pages for formatting (especially inline code chunks) and content.
- Fix wiki links?
- Add pages to the table of contents (
index.rst).