torproject/webwml
1
0
Fork 0
mirror of https://github.com/torproject/webwml.git synced 2024-12-17 07:16:56 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
a8b3786f46
webwml/include
History
Andrew Lewman a57cbe3189 add xpdm back to the list, fix theonionrouter domain
2011-11-25 03:56:54 +00:00
..
dlhead.wmi in the download-easy javascript magic, when the user chooses a different 2011-11-14 21:54:03 +00:00
foot.wmi comment out careers in the footer, comment out the language switch cgi 2011-06-08 11:37:46 +00:00
functions.wmi switch to Goldstein's idea of $lang/$dir/$page to keep all languages in 2010-07-14 19:39:08 +00:00
head.wmi Add cta-buttons.jpg, change the floating call to action buttons, modify 2011-06-06 00:54:21 +00:00
info.wmi fix run-on sentence 2010-10-09 23:16:47 +00:00
lang.wmi Move download/en/lang.wmi to include/lang.wmi 2011-09-04 21:45:45 +00:00
links.wmi define doxygen as a tag, move short user manual to the manual section, add the doxygen link. 2011-10-27 16:12:08 +00:00
mirrors-table.wmi add xpdm back to the list, fix theonionrouter domain 2011-11-25 03:56:54 +00:00
navigation.wmi make download-easy the default. 2011-09-04 13:42:33 +00:00
perl-globals.wmi we do not need ar-se 2011-09-10 16:54:41 +00:00
README first cut of the new, shiny tor website as wml. 2010-07-09 01:55:22 +00:00
side.wmi first cut of the new, shiny tor website as wml. 2010-07-09 01:55:22 +00:00
thankyou-head.wmi mv the wmi file into include 2011-09-21 21:57:25 +00:00
versions.wmi bump packages to 0.2.3.8-alpha and update tbbs for new firefox 2011-11-24 15:45:11 +00:00

README 

Here's a brief overview of how our wml set-up works.
----------------------------------------------------

Here's a typical wml file:
https://svn.torproject.org/svn/website/trunk/en/bridges.wml

The top of the file has:

  ## translation metadata
  # Revision: $Revision$
  # Translation-Priority: 1-high

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

  <div class="main-column">

and the bottom of the file has:

    </div><!-- #main -->

  #include <foot.wmi>

and the middle is standard html, plus a few extra tags like
<page> that we've added to automatically link to the translated
pages when they exist. So that wml page produces this html page:
https://www.torproject.org/bridges aka
https://www.torproject.org/bridges.html.en

Then head.wmi and foot.wmi are just other mostly-html files you import
to handle the repeat parts of each page (well, that plus some embedded
perl scripts to generate some of the static content).
https://svn.torproject.org/svn/website/trunk/include/head.wmi
https://svn.torproject.org/svn/website/trunk/en/foot.wmi

You can basically ignore the wml part of them, and to a first
approximation just think of them as more html.

So in summary, wml is like html with a bit more markup.

----------------------------------------------------

Where it gets interesting is the download page:
https://svn.torproject.org/svn/website/trunk/en/easy-download.wml

It has the standard header and footer section, but in the body of the page
it includes links like <a href="<package-osx-bundle-stable>". Rather than
putting URLs and Tor versions into every wml page, and then requiring
the translators to update their page whenever we bump a version number,
we instead define each URL and version as a new wml element:
https://svn.torproject.org/svn/website/trunk/include/versions.wmi