docs/usage/generate-static-files.md - Issue 29628724: Issue 5521 - Restructure CMS documentation to make it easier to use and extend

Side by Side Diff

Use n/p to move between diff chunks; N/P to move between comments.

Keyboard Shortcuts

	File
u :	up to issue
m :	publish + mail comments
M :	edit review message
j / k :	jump to file after / before current file
J / K :	jump to next file with a comment after / before current file
	Side-by-side diff
i :	toggle intra-line diffs
e :	expand all comments
c :	collapse all comments
s :	toggle showing all comments
n / p :	next / previous diff chunk or comment
N / P :	next / previous comment
<Up> / <Down> :	next / previous line
<Enter> :	respond to / edit current comment
d :	mark current comment as done

	Issue
u :	up to list of issues
m :	publish + mail comments
j / k :	jump to patch after / before current patch
o / <Enter> :	open current patch in side-by-side view
i :	open current patch in unified diff view

	Issue List
j / k :	jump to issue after / before current issue
o / <Enter> :	open current issue
# :	close issue

	Comment/message editing
<Ctrl> + s or <Ctrl> + Enter :	save comment
<Esc> :	cancel edit

Side by Side Diff: docs/usage/generate-static-files.md

Issue 29628724: Issue 5521 - Restructure CMS documentation to make it easier to use and extend (Closed) Base URL: https://hg.adblockplus.org/cms

Patch Set: Add initial API docs Created Dec. 13, 2017, 11:08 a.m.

Left:
Right:

Use n/p to move between diff chunks; N/P to move between comments.

Jump to:

OLD	NEW
(Empty)
	1 # Generating static files #

	2

	3 On your production server you should convert the content directory into static

	4 files. To do that you need:

	5

	6 * Python 2.7

	7 * [Jinja2](http://jinja.pocoo.org/) and

	8 [Markdown](https://pypi.python.org/pypi/Markdown) modules (can be installed by

	9 running `easy_install Jinja2 Markdown` from the command line)

	10 * A current copy of the

	11 [cms repository](https://github.com/adblockplus/cms/) (can be

	12 [downloaded as ZIP file](https://github.com/adblockplus/cms/archive/master.zip )

	13 or cloned via `git clone https://github.com/adblockplus/cms.git`)

	14

	15 Run the following command from the directory of the `cms` repository:

	16

	17 python -m cms.bin.generate_static_pages www_directory target_directory

	18

	19 Here `www_directory` should be replaced by the path to your content directory.

	20 `target_directory` is the path where static files will be placed.

	21

	22 Note: Localized versions of pages will only be generated when their translations

	23 are at least 30% complete. (Measured by comparing the total number

	24 of translatable strings on a page to the number of strings that have been

	25 translated for a given locale.) This is different from the test server which

	26 will include less complete translations.

OLD	NEW