wiki:org/operations/services/support

Support Portal

Tor Support Portal is a static site based on ​Lektor. You can also check ​Support Portal repository.

The Support Portal is hosted at several computers for redundancy, and these computers are together called "the www rotation". Please check the ​static sites help page for more info.

The support portal has a staging environment: support-staging.torproject.org

And a production environment: support.torproject.org

Content and Translations

The support portal fetches content from the https://gitweb.torproject.org/project/web/support.git/tree/ *.lr files under the content folder. This are the pages to update with content, in English.

The contents+<locale>.lr files are generated automatically. Please don't update this pages directly because your work may be lost. The translations are located under the i18n folder: https://gitweb.torproject.org/project/web/support.git/tree/i18n . You can translate them through Transifex (needs login) at https://www.transifex.com/otf/torproject/support-portal/

Inside the content folder, each subfolder represents a support topic. In this case the contents.lr is where the topic title is defined and the control key that decides the order of the topic within all the questions list. Dont edit the locale files, only the contents.lr file Example: https://gitweb.torproject.org/project/web/support.git/tree/content/connecting

For each topic folder there will be a number of subfolders representing a question each. For each question there is a .lr file and locale files in the format contents+<locale>.lr. Dont edit the locale files, only the contents.lr file. Example: https://gitweb.torproject.org/project/web/support.git/tree/content/connecting/connecting-2/

Inside a contents file you will find question title and description in the format:

_model: question
---
title: Our website is blocked by a censor. Can Tor Browser help users access our website?
---
description:

Tor Browser can certainly help people access your website in places where it is blocked.
Most of the time, simply downloading the ​<mark><a href="https://www.torproject.org/download/download-easy.html.en">Tor Browser</a></mark> and then using it to navigate to the blocked site will allow access.
In places where there is heavy censorship we have a number of censorship circumvention options available, including ​<mark><a href="https://www.torproject.org/docs/pluggable-transports.html.en">pluggable transports</a></mark>.

For more information, please see the <mark><a href="https://tb-manual.torproject.org/en-US/">​Tor Browser User Manual</a></mark> section on <mark><a href="https://tb-manual.torproject.org/en-US/circumvention.html">censorship</a></mark>.

When creating a document:

  • Use MarkDown format to generate the layout more cleanly. Try to avoid unnecessary html tags.
  • Add a line break after each period to create a new translation string. 2 linebreaks to create a paragraph.

Compiling a local version of the Support Portal

  1. Get lektor: https://www.getlektor.com/downloads/
  2. Clone the repo: https://gitweb.torproject.org/project/web/support.git
  3. Get on the repo and install the i18n plugin:
cd support

Then you can make changes to the contents.lr files, and then

lektor build
lektor server

Add a new language to the support portal

To add a new language, it should appear at one of the branches at https://gitweb.torproject.org/translation.git/refs/heads

You will need to edit this files:

- databags/alternatives.ini
- configs/i18n.ini 
- portal.lektorproject

and then, create the files:

export lang=bn_BD
cp databags/menu+en.ini databags/menu+$lang\.ini
cp databags/topics+en.ini databags/topics+$lang\.ini

Support Portal's Ticket Query

Ticket Status Summary Owner Reporter
#27770 assigned Support portal -- question permalink view breaks sidebar hiro alison
#27682 new Verifying signatures on Android hiro towiw3
#27613 new Tor Browser manual link appear in Danish in Tails hiro arthuredelstein
#27562 new Detect the locale and automatically serve the language specific support portal hiro sukhbir
#27561 new Changing the language of a permalink should redirect to the same permalink in that language hiro sukhbir
#27533 assigned add update of git submodule to support portal jenkins job weasel emmapeel
#27354 new Support: Add instruction to change the config hiro traumschule
#27203 needs_review The Tor icon on the support page does not show up when security setting is set to safest. hiro Dbryrtfbcbhgf
#26809 assigned add all Tier-1 languages to the support portal to test them hiro emmapeel
#23371 new adding a short paragraph on how to protect themself anonymous on internet and outside of it to " Tips On Staying Anonymous » " hiro throwable_account

Last modified 2 weeks ago Last modified on Sep 11, 2018, 2:24:59 PM