tor-webwml.git

@@ -1,16 +0,0 @@

-\relax 

-\@writefile{toc}{\contentsline {section}{\numberline {1}introduction}{1}}

-\@writefile{toc}{\contentsline {section}{\numberline {2}/include}{1}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {2.1}head.wmi}{1}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {2.2}foot.wmi}{2}}

-\newlabel{side-navigation}{{2.2}{2}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {2.3}side.wmi}{2}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {2.4}functions.wmi}{3}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {2.5}perl-globals.wmi}{3}}

-\newlabel{cgi-trampoline}{{2.5}{3}}

-\@writefile{toc}{\contentsline {section}{\numberline {3}languageswitch.cgi}{3}}

-\@writefile{toc}{\contentsline {section}{\numberline {4}building the site}{4}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {4.1}build prerequisites}{4}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {4.2}build translation po files}{4}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {4.3}import translated pages}{4}}

-\@writefile{toc}{\contentsline {subsection}{\numberline {4.4}build}{4}}

@@ -1,94 +0,0 @@

-This is pdfTeXk, Version 3.141592-1.40.3 (Web2C 7.5.6) (format=pdflatex 2010.6.1)  21 JUN 2010 02:08

-entering extended mode

- %&-line parsing enabled.

-**torproject.tex

-(./torproject.tex

-LaTeX2e <2005/12/01>

-Babel <v3.8h> and hyphenation patterns for english, usenglishmax, dumylang, noh

-yphenation, loaded.

-(/usr/share/texmf-texlive/tex/latex/base/article.cls

-Document Class: article 2005/09/16 v1.4f Standard LaTeX document class

-(/usr/share/texmf-texlive/tex/latex/base/size11.clo

-File: size11.clo 2005/09/16 v1.4f Standard LaTeX file (size option)

-)

-\c@part=\count79

-\c@section=\count80

-\c@subsection=\count81

-\c@subsubsection=\count82

-\c@paragraph=\count83

-\c@subparagraph=\count84

-\c@figure=\count85

-\c@table=\count86

-\abovecaptionskip=\skip41

-\belowcaptionskip=\skip42

-\bibindent=\dimen102

-) (./torproject.aux)

-\openout1 = `torproject.aux'.

-

-LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 2.

-LaTeX Font Info:    ... okay on input line 2.

-LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 2.

-LaTeX Font Info:    ... okay on input line 2.

-LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 2.

-LaTeX Font Info:    ... okay on input line 2.

-LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 2.

-LaTeX Font Info:    ... okay on input line 2.

-LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 2.

-LaTeX Font Info:    ... okay on input line 2.

-LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 2.

-LaTeX Font Info:    ... okay on input line 2.

-

-Underfull \hbox (badness 10000) in paragraph at lines 99--110

-

- []

-

-[1

-

-{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}]

-Overfull \hbox (76.90027pt too wide) in paragraph at lines 141--141

-[]          \OT1/cmtt/m/n/10.95 onclick="window.location='tor-doc-relay.html.de

-'">Deutsch</option>[] 

- []

-

-

-Overfull \hbox (82.64896pt too wide) in paragraph at lines 141--141

-[]          \OT1/cmtt/m/n/10.95 onclick="window.location='tor-doc-relay.html.it

-'">Italiano</option>[] 

- []

-

-

-Overfull \hbox (37.5869pt too wide) in paragraph at lines 152--153

-\OT1/cmr/m/n/10.95 pages de-fault to the en-glish ver-sion. Ex-ter-nal links (e

-.g. http://check.torproject.org)

- []

-

-[2] [3]

-Overfull \hbox (7.09915pt too wide) in paragraph at lines 198--202

-\OT1/cmr/m/n/10.95 libhtml-clean-perl, libimage-size-perl, libperl5.10, libtidy

--0.99-0, libyaml-syck-

- []

-

-

-Overfull \hbox (25.16208pt too wide) in paragraph at lines 215--215

-[]\OT1/cmtt/m/n/10.95 TORGIT = PATH_TO_TOR_DEVELOPMENT   # the path to developm

-ent branch[] 

- []

-

-[4] (./torproject.aux) ) 

-Here is how much of TeX's memory you used:

- 214 strings out of 95086

- 2338 string characters out of 1183256

- 49015 words of memory out of 1500000

- 3469 multiletter control sequences out of 10000+50000

- 5318 words of font info for 20 fonts, out of 1200000 for 2000

- 28 hyphenation exceptions out of 8191

- 21i,5n,19p,618b,241s stack positions out of 5000i,500n,6000p,200000b,5000s

-</usr/share/texmf-texlive/fonts/type1/bluesky/cm/cmbx12

-.pfb></usr/share/texmf-texlive/fonts/type1/bluesky/cm/cmr10.pfb></usr/share/tex

-mf-texlive/fonts/type1/bluesky/cm/cmtt10.pfb>

-Output written on torproject.pdf (4 pages, 42120 bytes).

-PDF statistics:

- 27 PDF objects out of 1000 (max. 8388607)

- 0 named destinations out of 1000 (max. 131072)

- 1 words of extra memory for PDF output out of 10000 (max. 10000000)

-

@@ -1,233 +0,0 @@

-\documentclass[11pt]{article}

-\begin{document}

-

-\section{introduction}

-This document (which may be found in /documentation) explains the wml code used to generate the Tor Project website. The original Tor Project documentation in /include/README gives a brief overview of Tor Project's use of wml. Some additional embedded perl was added to generate static content, namely navigation bars and a language selection dropdown in the footer of the page. Adding new content to the site is done by adding the new wml source files and an entry in the relavent navigation bar. Section \ref{side-navigation} outlines the syntax for the menu structure and section.

-

-%\section{/}

-%   home.wml 

-%

-%\section{/about}

-%   about.wml

-%   board.wml

-%   contact.wml

-%   contributors.wml

-%   future.wml

-%   gsoc.wml

-%   overview.wml

-%   people.wml

-%   sidenav.wmi

-%   sponsors.wml

-%   staying.wml

-%   torusers.wml

-%   translators.wml

-%   volunteers.wml

-%   why.wml

-%

-%\section{/docs}

-%   android.wml

-%   bridges.wml

-%   debian-vidalia.wml

-%   debian.wml

-%   documentation.wml

-%   faq-abuse.wml

-%   faq.wml

-%   gloassary.wml

-%   hidden-services.wml

-%   installguide.wml

-%   manual.wml

-%   N900.wml

-%   rpms.wml

-%   running-a-mirror.wml

-%   sidenav.wmi

-%   tor-doc-osx.wml

-%   tor-doc-relay.wml

-%   tor-doc-unix.wml

-%   tor-doc-web.wml

-%   tor-doc-windows.wml

-%   tor-hidden-service.wml

-%   tor-manual-dev.wml

-%   tor-manual.wml

-%   trademark-faq.wml

-%   verifying-signatures.wml

-%

-%\section{/download}

-%   download.wml

-%   easy-download.wml

-%   thankyou.wml

-%

-%\section{/getinvolved}

-%   developers.wml

-%   everyone.wml

-%   getinvolved.wml

-%   mirrors.wml

-%   open-positions.wml

-%   sidenav.wmi

-%   technical.wml

-%   translation-overview.wml

-%   translation-portal.wml

-%   translation-status.wml

-%   translation.wml

-%   tshirt.wml

-%   volunteer.wml

-%

-%\section{/press}

-%   2008-12-19-roadmap-press-release.wml

-%   2009-03-12-performance-roadmap-press-release.wml

-%   2010-03-25-tor-store-press-release.wml

-%   index.wml

-%   info.wmi

-%   inthemedia.wml

-%   pressreleases.wml

-%   press.wml

-%   sidenav.wmi

-%

-%\section{/projects}

-%   clientside.wml

-%   google.wml

-%   hidserv.wml

-%   index.wml

-%   lowbandwidth.wml

-%   projects.wml

-%   sampleproject.wml

-%   sidenav.wmi

-%   torbutton-faq.wml

-%   torbutton-options.wml

-%   torbutton.wml

-

-\section{/include}

-Files present:\\

-foot.wmi - document footer\\

-functions.wmi - translation functions\\

-head.wmi - document head\\

-info.wmi - info snippet\\

-links.wmi - functions to generate links\\

-mirrors-table.wmi - mirror list\\

-navigation.wmi - input to head.wmi navigation menu\\

-perl-globals.wmi - global variables\\

-side.wmi - side menu navigation\\

-versions.wmi - version number macros\\

-

-\subsection{head.wmi}

-  This is the main header for all site documents. The main navigation bar is generated at build time here by referencing a language-specific file (navigation.wmi) which contains a list of URLs and the link text to display.

-  

-\begin{verbatim}

-   example path: /en/navigation.wmi

-   example path: /de/navigation.wmi

-\end{verbatim}

-  

-  Translators can create a language-specific version in order to generate the top navbar.

-

-  The second navigation element, 'calltoaction' is generated similarly from the second list in navigation.wmi

-  

-\subsection{foot.wmi}

-   This is the footer for all site documents. There are quick links to site content as well as a translation selection menu.

-   Translation selection:

-  At build time, available languages are detected by the presence of a language subdirectory:

-

-  example:

-

-/about/en/about.wml contains valid translations for nl, and de if files /about/nl/about.wml and /about/de/about.wml exist. For each translated language a <select> <option> is created. Javascript onClick is used to direct clients that support javascript, but if the client does not support javascript a simple perl cgi trampoline may be used to redirect the client to the selected page on form submit. (see: \ref{cgi-trampoline})

-\begin{verbatim}

-<form action="../cgi-bin/languageswitch.cgi">

-   <select name="Language" id="lang">

-      <option value="docs/tor-doc-relay.html.de"

-          onclick="window.location='tor-doc-relay.html.de'">Deutsch</option>

-      <option value="docs/tor-doc-relay.html.it"

-          onclick="window.location='tor-doc-relay.html.it'">Italiano</option>

-   </select>

-   <input class="go" type="submit" name="submit" value="Go">

-</form>

-\end{verbatim}

-

-\label{side-navigation}

-\subsection{side.wmi}

-This is the side navbar generator for documents that utilize a side navbar. A language-specific sidenav.wmi file contains a hierarchical structure of menu elements.

-

-\begin{verbatim}

-example path: /about/en/sidenav.wmi

-example path: /docs/de/sidenav.wmi

-\end{verbatim}

-

-Each element contains url and txt fields and may also contain a list of subelements. At build time the navbar is rendered for each page so that nested elements are expanded/collapsed and css styles are set. Untranslated pages default to the english version. External links (e.g. http://check.torproject.org) are inserted without modification.

-

-example structure:

-

-\begin{verbatim}

-

-  $sidenav = [

-      {'url'  => 'about/about',

-       'txt'  => 'Tor Overview',

-       'subelements' => [

-          {'url'  => 'about/why',

-           'txt'  => 'Why We Need Tor',

-          },

-          {'url'  => 'about/staying',

-           'txt'  => 'Staying Anonymous',

-          },

-          {'url'  => 'about/future',

-           'txt'  => 'Future of Tor',

-          }]

-      }

-  ];

-

-\end{verbatim}

-

-\subsection{functions.wmi}

-An additional function pageToURL(\$\$) performs the same conversion as <page> tags, but may be called from within eperl statements (such as those used to generate the navigation structure). The arguments to the function are \$page, \$lang, where \$page is the document path (e.g. /docs/tor-doc-osx) and \$lang is the language (e.g. en, de, it).

-

-\subsection{perl-globals.wmi}

-An additional global variable (\$WML\_SRC\_DIRNAME) was added for use in determining the input file path.

-

-

-\label{cgi-trampoline}

-\section{languageswitch.cgi}

-   The language selection dropdown (see document footer: foot.wmi) requires javascript support or a server-side script to handle a form submit. languageswitch.cgi is a perl cgi script that returns a URL passed by GET as a redirect.

-\begin{verbatim}

-#!/usr/bin/env perl

-

-use CGI qw(:standard);

-my $lang = param('Language');

-print "Status: 302 Moved\nLocation: /$lang\n\n";

-\end{verbatim}

-

-\section{building the site}

-\subsection{build prerequisites}

-The ubuntu package wml has these dependencies:

-

-eperl, iselect, libbit-vector-perl, libcarp-clan-perl,

-libgetopt-argvfile-perl, libhtml-clean-perl,

-libimage-size-perl, libperl5.10, libtidy-0.99-0,

-libyaml-syck-perl, linklint, m4, mp4h, slice, tidy, txt2html, wml

-

-Make sure that you have checked out the translation project: \\

-https://svn.torproject.org/svn/translation/ \\

-as well as the website project: \\

-https://svn.torproject.org/svn/website/

-

-In addition to the translation project, you must also check out stable and development branches of tor, which are used to generate the online version of the manpages. The path to these repositories must be set the Makefile as follows:

-

-\begin{verbatim}

-TORSVNSTABLE = PATH_TO_TOR_STABLE  # the path to stable branch

-TORGIT = PATH_TO_TOR_DEVELOPMENT   # the path to development branch

-STABLETAG = CURRENT_STABLE_TAG     # stable tag

-DEVTAG = CURRENT_DEV_TAG           # dev tag

-\end{verbatim}

-

-\subsection{build translation po files}

-\begin{verbatim}

-./wml2po.sh

-\end{verbatim}

-

-This script parses the english wml and generates po files for use with pootle

-\subsection{import translated pages}

-\begin{verbatim}

-make translations

-\end{verbatim}

-

-This commands calls the script po2wml.sh, which converts translated po files to language-specific wml which will then build translated pages.

-\subsection{build}

-\begin{verbatim}

-make

-\end{verbatim}

-\end{document}