If you visit https://publiclab.org/wiki/guides#Translations, you will see that the balloon mapping guide has been translated into a dozen languages—Arabic, Castellano/Spanish, Portuguese, Georgian, Hebrew, Korean, Chilean, Ukranian, Russian, Turkish/Türkçe, Dutch/Nederlands, and German. These translation efforts take place in Google Docs Presentations, which exist for each tool listed on http://publiclab.org/guides. Many of these translations were made by people organizing workshops in their areas, and sharing back the resources they created with the community.
NOTE: These collaborative translation efforts build on collaborative writing efforts, such as https://publiclab.org/notes/warren/07-01-2017/collaboratively-write-the-new-pocket-guide-to-grassroots-mapping. It's collaborative turtles all the way down! 🐢
To translate a tool guide, follow these steps:
- Visit https://publiclab.org/guides
- Browse through the headers to find the tool you are interested in. If you do not see the tool you are interested in already listed, skip down to the next section in this post.
- Find the link that reads something like "Anyone can print, add to or edit this Google Doc," and click this link.
- Make a copy of this doc titled with the "[same name]—name of new language"
- In this new Google Doc, replace the existing texts with your translated texts.
- Adjust the setting on your doc to be "viewable to anyone on the internet"
- Export a PDF, naming it "[tool name]—language name"
- Return to https://publiclab.org/guides, and click edit
- While editing, scroll down to your tool's section, and A) add a link to your translated Google Doc following the format of how others added links to their translations, and B) Drag and drop the PDF so it uploads onto the page as well. Click "Save".
- Hooray, you did it!
If your tool does not already have a guide listed:
Your mission will be to create a printable worksheet for the tool, like a one-page handout, that's great for workshops. To get started,
- Find where documentation on your tool or method by A) searching in the Search box on the navigation bar at the top of PublicLab.org on all pages, or by B) browsing https://publiclab.org/methods
- Create a google doc with a few simple illustrations, and a few brief captions that will be suitable for using during a workshop. Keep it to one page, or a few pages. Shorter is better! The website is the best place for long form documentation, so no need to duplicate everything.
- Return to to https://publiclab.org/guides and click the "pencil icon" to edit the page. Add a header for the tool you're working on. Under this header, add a link to your Google Doc, with the link text reading "Anyone can print, add to or edit this Google Doc". Click "Save".
- Hooray, you did it!
- Return to the steps above on translation.