Synchronized build

Author: lektor-bot

contributing-code/translation-guide/index.html

@@ -119,7 +119,7 @@ <h2>Our Work Relies On You!</h2>
 <header>
   <h1>Translation Guide</h1>
   <p>Our translation files are hosted and managed on
-<a href="https://www.transifex.com">Transifex</a>. It is very easy to sign up for an
+<a href="https://www.transifex.com/">Transifex</a>. It is very easy to sign up for an
 account and start translation Creative Commons (CC) services into another
 language.</p>
 
@@ -213,6 +213,22 @@ <h2>On this page</h2>
                 <li>
                     <a href="#for-translators">For translators</a>
 
+                        <ul>
+                            
+                                <li>
+                                    <a href="#signing-up">
+                                      Signing up
+                                    </a>
+                                </li>
+                            
+                                <li>
+                                    <a href="#using-transifex">
+                                      Using Transifex
+                                    </a>
+                                </li>
+                            
+                        </ul>
+                    
                 </li>
 
                 <li>
@@ -232,15 +248,14 @@ <h2>On this page</h2>
 <div class="content">
     <!-- disregard: vim syntax highlighting fix_ -->
 
-<p>CC applications such as CC Search and the CC Chooser are used by millions of
-users worldwide. Translating these services into the languages our users speak
-and read is integral to making these services accessible to our diverse user
-base.</p>
+<p>CC applications are used by millions of users worldwide. Translating these
+services into the languages our users speak and read is integral to making
+these services accessible to our diverse user base.</p>
 <p>We use Transifex to manage our translation files. It provides an intuitive UI
 and many useful tools. Let's see how you can join us there and get started.</p>
 <p>TL;DR: We have a <a href="https://www.youtube.com/watch?v=Rta2AlPww8M">video version</a>
 of this tutorial if you prefer that as the medium of instruction.</p>
-<h2 id="for-translators">For translators</h2><ul>
+<h2 id="for-translators">For translators</h2><h3 id="signing-up">Signing up</h3><ol>
 <li><strong>Sign up on Transifex</strong><ul>
 <li>Visit the Transifex <a href="https://www.transifex.com/signup/">sign up page</a> and
 fill out the form to create an account.</li>
@@ -249,104 +264,93 @@ <h2 id="for-translators">For translators</h2><ul>
 <li>Alternatively you can link an existing account from GitHub, Google or
 LinkedIn to avoid having to remember another password.</li>
 <li>During the sign up process, you will be asked for the languages you speak.
-Remember to fill it as comprehensively as possible.</li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+Remember to fill it as comprehensively as possible.
 <img
   style="max-height: 508px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex sign up page"
-  src="./transifex_signup.png">
-</p><ul>
-<li><p><strong>Verify your email</strong>
-You will receive an email from Transifex on the email address you signed up.
-Clicking the link in the email will verify that you used an authentic email to
-sign up and enable all the features on your account.</p>
-</li>
-<li><p><strong>Visit the CC Organisation page</strong>
-The <a href="https://www.transifex.com/creativecommons/public/">organisation page</a>
-contains links to all CC projects currently in translation.</p>
+  src="./transifex_signup.png"></li>
+</ul>
 </li>
+<li><strong>Verify your email</strong><ul>
+<li>You will receive an email from Transifex on the email address you signed
+up. Clicking the link in the email will verify that you used an authentic
+email to sign up and enable all the features on your account.</li>
 </ul>
-<p style="text-align: center;">
+</li>
+<li><strong>Visit the CC Organisation page</strong><ul>
+<li>The <a href="https://www.transifex.com/creativecommons/public/">organisation page</a>
+contains links to all CC projects currently in translation.
 <img
   style="max-height: 508px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex 'CC' organisation page"
-  src="./transifex_org_page.png">
-</p><ul>
-<li><strong>Choose a project</strong>
-Choose any project from the list that you would like to translate. Click on
-the project name to go to the project page.</li>
+  src="./transifex_org_page.png"></li>
 </ul>
-<p style="text-align: center;">
+</li>
+<li><strong>Choose a project</strong><ul>
+<li>Choose any project from the list that you would like to translate. Click
+on the project name to go to the project page.
 <img
   style="max-height: 508px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex 'Summit website' project page"
-  src="./transifex_summit.png">
-</p><ul>
+  src="./transifex_summit.png"></li>
+</ul>
+</li>
 <li><strong>Join the team</strong><ul>
-<li>You can see a list of languages that each project has been translated into.
-Not all languages are visible. Click on the 'Display all languages' button
-to see them all.</li>
+<li>You can see a list of languages that each project has been translated
+into.  Not all languages are visible. Click on the 'Display all languages'
+button to see them all.</li>
 <li>If your language isn't present in the list, you can request for it by
-clicking the 'Request language' button. You will have to go to the previous
-step and find a different project till your language request is approved.</li>
+clicking the 'Request language' button. You will have to go to the
+previous step and find a different project till your language request is
+approved.</li>
 <li>If your language is present, click on the 'Join team' button to join the
 team that's translating this project.</li>
 <li>In the modal choose your language and click the 'Join' button. You'll
 receive a notification that a request has been submitted.</li>
 <li>Notify the <code># Translation</code> channel on <a href="/community/#zulip">Zulip</a></li>
-<li>Wait for an administrator to add you to the team.</li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+<li>Wait for an administrator to add you to the team.
 <img
   style="border: 1px solid #ccc;"
   alt="Screenshot of the Transifex 'Join project' modal"
-  src="./transifex_modal.png">
-</p><ul>
+  src="./transifex_modal.png"></li>
+</ul>
+</li>
+</ol>
+<h3 id="using-transifex">Using Transifex</h3><ul>
 <li><strong>Getting around</strong><ul>
 <li>You'll receive an email when your request has been accepted.</li>
 <li>When you log back in to Transifex, you'll see some changes in the UI.<ul>
 <li>You'll have Creative Commons mentioned in the organisation dropdown.</li>
 <li>You'll see CC projects in the left sidebar.</li>
 </ul>
 </li>
-<li>Click on the project of your choice from the sidebar.</li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+<li>Click on the project of your choice from the sidebar.
 <img
   style="max-height: 508px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex 'Summit website' member view"
-  src="./transifex_member_view.png">
-</p><ul>
+  src="./transifex_member_view.png"></li>
+</ul>
+</li>
 <li><strong>Translate the strings</strong><ul>
 <li>Find your language from the list of languages. Hovering over the name will
 reveal a 'View resource' button.</li>
 <li>Click on the 'View resource' button. That should take you to the page of
 that particular language. It contains the resources that you need to
 translate.</li>
-<li>Clicking on the resource opens a modal describing the words and strings that
-remain to be translated. Here onwards you have three paths for translating
-the site.<ul>
+<li>Clicking on the resource opens a modal describing the words and strings
+that remain to be translated. Here onwards you have three paths for
+translating the site.<ul>
 <li>Transifex editor UI, by clicking the 'Translate' button</li>
 <li>Transifex live UI, by clicking the 'Live' button</li>
-<li>Local string translation, by clicking the download and upload buttons</li>
+<li>Local string translation, by clicking the download and upload buttons
+<img
+style="border: 1px solid #ccc;"
+alt="Screenshot of the Transifex resource modal"
+src="./transifex_resource_modal.png"></li>
 </ul>
 </li>
 </ul>
 </li>
-</ul>
-<p style="text-align: center;">
-<img
-  style="border: 1px solid #ccc;"
-  alt="Screenshot of the Transifex resource modal"
-  src="./transifex_resource_modal.png">
-</p><ul>
 <li><strong>Method 1: Translating using the Transifex editor UI</strong><ul>
 <li>To do this, click on the 'Translate' button from the resource modal. You
 will be taken to a list of all the strings from the website.</li>
@@ -358,16 +362,13 @@ <h2 id="for-translators">For translators</h2><ul>
 the source text to copy them over in the translated text. You can also drag
 to move them around as needed.</li>
 <li>Keep these instructions in mind: <a href="https://wiki.creativecommons.org/wiki/Translating_CC_Deeds#General_Notes_About_Translating">General Notes About Translating -
-Translating CC Deeds - CC Public Wiki</a></li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+Translating CC Deeds - CC Public Wiki</a>
 <img
   style="max-height: 508px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex editor UI"
-  src="transifex_editor_ui.png">
-</p><ul>
+  src="transifex_editor_ui.png"></li>
+</ul>
+</li>
 <li><strong>Method 2: Translating using the Transifex live UI</strong><ul>
 <li>To do this, click on the 'Live' button from the resource modal. You will be
 taken to the website rendered in the Transifex page and you can edit the
@@ -377,16 +378,13 @@ <h2 id="for-translators">For translators</h2><ul>
 <li>All the text is green boxes can be translated. Click on the pencil icon
 that appears when you move your mouse over the green boxes.</li>
 <li>Enter your translated string in the lower box and press the 'Save' button
-to confirm the translation.</li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+to confirm the translation.
 <img
   style="max-height: 508px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex live UI"
-  src="transifex_live_ui.png">
-</p><ul>
+  src="transifex_live_ui.png"></li>
+</ul>
+</li>
 <li><strong>Method 3: Translating strings locally</strong><ul>
 <li>To do this, you can download the JSON file that maps English strings to
 their counterparts in your language by clicking the 'Download file to
@@ -400,40 +398,37 @@ <h2 id="for-translators">For translators</h2><ul>
 <li>Upload the translated JSON file using the 'Upload file' button.</li>
 </ul>
 </li>
+<li>Your translations will go live as soon as they are approved by the admins.</li>
 </ul>
-<p>Your translations will go live as soon as they are approved by the admins.</p>
 <h2 id="for-admins">For admins</h2><ul>
 <li><strong>Approve team join requests</strong><ul>
 <li>Click on the person's name to see their profile. That could help in
 determining the credibility of the candidate.</li>
 <li>Click the 'Accept' button if you want to add the collaborator to the team.
-You'll receive a notification confirming the acceptance of the translator.</li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+You'll receive a notification confirming the acceptance of the translator.
 <img
   style="max-height: 503px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex 'Join requests' page"
-  src="./transifex_join_request.png">
-</p><ul>
+  src="./transifex_join_request.png"></li>
+</ul>
+</li>
 <li><strong>Review translations</strong><ul>
 <li>Navigate to the resource as described for translators in the 'Translate the
 strings' section.</li>
 <li>In the resource modal that appears, click on the 'View strings online'
 button. You will be taken to the strings page.</li>
 <li>Click on the 'Unreviewed' tab. Approve or decline the translation as
-applicable.</li>
-</ul>
-</li>
-</ul>
-<p style="text-align: center;">
+applicable.
 <img
   style="max-height: 503px; border: 1px solid #ccc;"
   alt="Screenshot of the Transifex 'Unreviewed translations' page"
-  src="./transifex_review_translation.png">
-</p><h2 id="additional-resources">Additional resources</h2><ul>
+  src="./transifex_review_translation.png"></li>
+</ul>
+</li>
+</ul>
+<h2 id="additional-resources">Additional resources</h2><ul>
 <li><a href="https://wiki.creativecommons.org/wiki/Translate">Translate - CC Public Wiki</a></li>
+<li><a href="https://help.transifex.com/">Transifex Help Center</a></li>
 </ul>
 
 </div>