tor-webwml.git

1) Here's a brief overview of how our wml set-up works.
2) ----------------------------------------------------
3) 
4) Here's a typical wml file:

5) https://gitweb.torproject.org/project/web/webwml.git/tree/docs/en/bridges.wml
6) http://jqs44zhtxl2uo6gk.onion/project/web/webwml.git/tree/docs/en/bridges.wml

7) 
8) The top of the file has:
9) 
10)   ## translation metadata
11)   # Revision: $Revision$
12)   # Translation-Priority: 1-high
13) 

14)   #include "head.wmi" TITLE="Tor: Bridges"

15) 
16)   <div class="main-column">
17) 
18) and the bottom of the file has:
19) 
20)     </div><!-- #main -->
21) 
22)   #include <foot.wmi>
23) 
24) and the middle is standard html, plus a few extra tags like
25) <page> that we've added to automatically link to the translated
26) pages when they exist. So that wml page produces this html page:
27) https://www.torproject.org/bridges aka
28) https://www.torproject.org/bridges.html.en

29) https://www.torproject.org/docs/bridges

30) http://expyuzz4wqqyqhjn.onion/docs/bridges

31) 
32) Then head.wmi and foot.wmi are just other mostly-html files you import
33) to handle the repeat parts of each page (well, that plus some embedded
34) perl scripts to generate some of the static content).

35) https://gitweb.torproject.org/project/web/webwml.git/tree/include/head.wmi
36) http://jqs44zhtxl2uo6gk.onion/project/web/webwml.git/tree/include/head.wmi
37) https://gitweb.torproject.org/project/web/webwml.git/tree/include/foot.wmi
38) http://jqs44zhtxl2uo6gk.onion/project/web/webwml.git/tree/include/foot.wmi

39) 
40) You can basically ignore the wml part of them, and to a first
41) approximation just think of them as more html.
42) 
43) So in summary, wml is like html with a bit more markup.
44) 
45) ----------------------------------------------------
46) 
47) Where it gets interesting is the download page:

48) https://gitweb.torproject.org/project/web/webwml.git/tree/download/en/download-easy.wml
49) http://jqs44zhtxl2uo6gk.onion/project/web/webwml.git/tree/download/en/download-easy.wml

50) 
51) It has the standard header and footer section, but in the body of the page
52) it includes links like <a href="<package-osx-bundle-stable>". Rather than
53) putting URLs and Tor versions into every wml page, and then requiring
54) the translators to update their page whenever we bump a version number,
55) we instead define each URL and version as a new wml element: