mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-03 21:43:21 +00:00 
			
		
		
		
	Improve docs/README.md
(imported from commit 78193958bdb5f92ae5d8706340a739dae0da5367)
This commit is contained in:
		@@ -1,3 +1,13 @@
 | 
			
		||||
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/html` subdirectory.
 | 
			
		||||
 | 
			
		||||
To create rST from MediaWiki input:
 | 
			
		||||
 | 
			
		||||
   * Use `pandoc -r mediawiki -w rst` on MediaWiki source.
 | 
			
		||||
@@ -11,7 +21,3 @@ We can use pandoc to translate mediawiki into reStructuredText, but some things
 | 
			
		||||
   * Fix wiki links?
 | 
			
		||||
   * Add pages to the table of contents (`index.rst`).
 | 
			
		||||
 | 
			
		||||
To generate HTML docs locally from RST:
 | 
			
		||||
 | 
			
		||||
   * `pip install sphinx`
 | 
			
		||||
   * In this directory, `make html`. Output appears in a `_build/html` subdirectory.
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user