[tor-bugs] #4165 [Website]: research migrating website from wml to markdown and jekyll

[Tor Bug Tracker & Wiki]

#4165: research migrating website from wml to markdown and jekyll
-------------------------+--------------------------------------------------
 Reporter:  phobos       |          Owner:  phobos
     Type:  enhancement  |         Status:  new   
 Priority:  normal       |      Milestone:        
Component:  Website      |        Version:        
 Keywords:               |         Parent:        
   Points:               |   Actualpoints:        
-------------------------+--------------------------------------------------
 We currently use the website meta language, http://thewml.org/, as our
 template system for creating the static html for the website. A more
 modern template system is Jekyll, http://jekyllrb.com/. We could do a
 better job of separating the content from the html itself by using
 markdown for all of the content, stored in distinct files, and then apply
 the html template using the YAML included in Jekyll.

 Having separate content may also improve our ability to include it as
 documentation with our software bundles and compiled as manuals for users.
 This separation may also improve our ability to translate the content
 without having to worry about conversion from html to the po format.

 Markdown is a language which can be converted from its plaintext form into
 various other formats, http://daringfireball.net/projects/markdown/.

 There would be a lot of work to setup the new site, convert the
 documentation, and merge in the current theme. However, the end result
 would be a more flexible arrangement for the future. New designs and
 templates could be applied more easily without the need to rewrite all of
 the content as well.

-- 
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/4165>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online