Translate the webcomic

Table of Content

  1. License and Code of Conduct
  2. Get the necessary tools
  3. Join us on Framagit
  4. Get the comic pages sources files
  5. Translate the SVG comic pages
  6. Credits and other files
  7. Upload your translation
  8. F.A.Q.

cover image

Translating an episode of Pepper&Carrot is fast, fun and easy! You can do it from any type of computer (Windows, Mac, Linux and more) and using only free/libre tools. In this documentation you'll be able to read all information about managing your own translation of Pepper&Carrot.

1. License and Code of Conduct

By submitting any translation or improvements to the Pepper&Carrot project, you accept that you release your work under the Creative Commons Attribution 4.0 International License (also named CC BY 4.0).

You also accept the terms of our Code of Conduct.

More info

The license CC BY 4.0 is a license that allows copy and redistribution the material in any medium or format. It includes remix, transform, and build upon the material for any purpose, **even commercially**. The condition: the re-user will need to always provide an appropriate credit. You acknowledge that you understand this license and you permit everyone to use your content under this license. You warrant that you have the right to grant this permission and you understand that under the terms of the CC BY 4.0 license you cannot later revoke it.

You are of course still free to make derivatives and translations of Pepper&Carrot and distribute them under other licenses, so long as you comply with the applicable licenses. But if you wish to have your translation included on the official website, you must release your work under CC BY 4.0.

- Note 1: You can find a similar license on the CONTRIBUTING file at the root of the repository.
- Note 2: I disagree with the reusage of my work for NFTs. I explain it on my blog.

โš– Attribution best practises

2. Get the necessary tools

Inkscape

This is our main tool for editing speech-bubbles and onomatopoeia. It's a free/libre and open-source software available for Windows, macOS and GNU/Linux.

๐Ÿ” Download Inkscape

Fonts

Pepper&Carrot translations uses only a set of open fonts. Some of them are in-house modified for the project and we distribute them. They are compatible Windows, macOS and GNU/Linux.

Font-pack for Windows
  1. Download peppercarrot-fonts-latest.zip
  2. Extract peppercarrot-fonts-latest.zip to a temporary folder.
  3. Open your Control Panel.
  4. Go into Appearance and Personalization.
  5. Open Fonts.
  6. Your folder font will open.
  7. Drag and drop the Pepper&Carrot fonts into the Fonts window.
  8. You can now remove your downloaded zip file and the folder you temporary extracted them.
Font-pack for MacOS
  1. Download peppercarrot-fonts-latest.zip
  2. Extract peppercarrot-fonts-latest.zip to a temporary folder.
  3. Open Finder.
  4. Open Applications in the sidebar.
  5. Select the Font Book application.
  6. Drag and drop the Pepper&Carrot fonts into Font Book window.
  7. You can now remove your downloaded zip file and the temporary folder where you extracted them.
Font-pack for GNU/Linux
  1. Download peppercarrot-fonts-latest.zip
  2. Extract peppercarrot-fonts-latest.zip to a temporary folder.
  3. Open your file manager.
  4. Show hidden files.
  5. Navigate to ~/.local/share/fonts (create the folder if necessary)
  6. Drag and drop the Pepper&Carrot fonts into ~/.local/share/fonts.
  7. You can now remove your downloaded zip file and the folder you temporary extracted them.

  8. Note: For Arch Linux and derivatives, a AUR exists: https://aur.archlinux.org/packages/peppercarrot-fonts/

3. Join us on Framagit

Framagit is a tool made for managing collaboratively software and it's hosted by the non-profit organisation Framasoft. You can find the Pepper&Carrot group on Framagit here. By creating an account on it, you'll be able to:

  • Collaborate on adding, modifying, removing files.
  • Discuss with us (using the 'issues' ticket).
  • Get notification when someone quote your account, and contact other translators.

This step can be optional but it will be harder to collaborate with you without an account (but you can still send your translations by email).

๐Ÿง Get a Framagit account

Activation issue?... Creating new account on Framagit sometimes takes 48h to be activated and you might not receive any notification about it. It's a known issue: just test to login 48h after account creation and you should be fine.

Once you have your account, tell us a little hello. Open a new issue ticket and present yourself. I'll then grant you permission to upload your files to the source and modify files. You'll join the long list of Members as a Pepper&Carrot Developer!

4. Get the comic pages sources files

Each pages you can see on the comic comes from the fusion of a SVG file (Inkscape) for speech-bubbles and a KRA file (Krita) for artworks. For translation, we only need the SVGs. Multiple methods exists depending of what you want to do:

Get the SVGs of a single episode
  1. Go on the page of the episode you want to edit (eg. Episode 1 in English)
  2. Click on the button 'Sources and license' on the top.
  3. Click on the link inside the gray button 'Text Sources'.
  4. Save the ZIP archive on your disk.
  5. Extract the files. Done.
Get the sources for all episodes
  1. Go to the webcomic repository on Framagit
  2. Near the blue button "Clone", you'll find a button with a Download icon.
  3. Click on the ZIP format.
  4. Save the ZIP archive on your disk.
  5. Extract the files. Done.
Advanced: clone the Git repository

On your command line enter:
git clone https://framagit.org/peppercarrot/webcomics.git

It will clone the webcomics repository.

5. Translate the SVG comic pages

screenshot of duplicating a folder (copy/paste), then renaming it to a fictive language named 'my'

Avoid duplicate efforts

Before starting to invest time and effort on your translation, be sure no-one else decided to work on this part too at the same time. It might waste your time! To avoid that:

  1. Read the issue tickets on Framagit to check if someone is already working on it.
  2. If not, it's a good idea to inform with a new issue tickets on Framagit that you are on it.

Editing the comic

Episode have directories formated like ep01_Potion-of-Flight, inside you'll find a subdirectory named lang. This directory contains all the translation already made for this episode. Open a language sub-directory and you'll see the SVGs pages ready to edit with Inkscape.

How to add a new language?
To create a new language, just copy/paste an existing language directory (the English directory en is the most used starting point, but feel free to start by the language of your choice) and then rename the pasted directory into your target language.

For the choice of the two small-case letters of your lang, try to use the ISO 639-1 language codes when it's possible, but if it doesn't exist, we have the flexibility to invent one. That's why we call our two-letter language code the Pepper&Carrot lang ID. Create a new issue tickets on Framagit to contact us if you have doubt about this two letter choice.

Later in the process, when your translation will be done, we'll need information about your new language. You'll have to edit the langs.json file at the root of the comic to enter this information. A dedicated page exist about this file; but don't worry too much if you can't edit it alone. We can help you later to do so.

Once in Inkscape, double clicking a text box will edit it. It's the same process for onomatopoeia. Speech-bubble and their tails are object you can resize, scale, rotate and move around. Resize them so they wrap better around your text. Feel free to be the art director of your translation: resize stuff and arrange the layout to your taste. Don't forget to fill in the credits for your translation on the credit page (the last page).

If you are interested in advanced Inkscape techniques and a FAQ about translation, read the Translation Tips page:

๐Ÿ’ฌ Translation Tips page

Note: If Inkscape prompts you with a dialog at start-up "Convert Legacy Inkscape file" looking like that, just keep the default option "This file contains digital artwork for screen display. (Choose if unsure)" and then press the OK button.

6. Credits and other files

info.json file

This file is important: it will manage your credit. You can simply edit it with a text editor. If you have doubt how to format it, just look how other language directory wrote it or check the full documentation:

๐Ÿ—’๏ธ info.json full documentation

References file

This file is optional: they help you to keep notes on how you translate characters, place and creature. It also helps to auto-generate transcripts.

If you have downloaded all the repository, you'll find the references of your language โˆ’a Po file named with the letter of your languageโˆ’ under the directory named 1_translation-names-references.

Edit the PO reference files

You can edit Po files with a simple text editor or a softwares for Po files. Poedit is a good Free/Libre and open-source software for that. The files are composed mainly of three type of entries. Here is a sample item from fr.po:

#. A student witch of Hippiah and also an elf, with red hair.
msgid "Cinnamon"
msgstr "Cannelle"

- First line (always starts by #.) is a comment to help you to get context
- The a line starting by msgid with the English reference (to leave as it is).
- Finally, the line starting by msgstr is the most important and the one to translate. (Note: keep the word wrapped between ")

Transcript

This file is optional: you don't need to translate it and you can delete it. Transcript are auto-generated later from the SVGs you translated. If you want to know how, check the transcript documentation:

๐Ÿ—’๏ธ Transcript full documentation

7. Upload your translation

When your translation is complete and looks good, it is time to send it to the Pepper&Carrot official website. You have mainly three options to upload your translation:

Post your translation on Framagit
    Note: for this steps, you'll need a Framagit account.

    Create a Branch
  1. Open the Branches page of the webcomic repository on Framagit
  2. Click the top-right colored button "New branch".
  3. Name your new branch as you want (eg. a short and informative "ep26-fr" for episode 26 in French)
  4. Leave other option unchanged and click the button "Create branch" on bottom-left to complete the creation.

  5. Add your file to the branch
  6. Right after the creation, the page probably reloaded directly inside your Branch. If you are not sure, you can still access your branch within the the Branches page and click on its title to display the repository of your branch.
  7. Then, in your branch, click the button 'Web IDE' on the header of the repository.
  8. The IDE will launch and a file listing will appear on the left of your monitor. With this menu, you can control the files: you can expand directories, use the three dots menu (appearing while having the cursor over a directory) to create 'New directory' and 'Upload files'. You can then create the directory of your lang and upload all your SVG at once this way.
  9. When it's done and you are happy with the modification, finalize your action with the blue 'Commit...' button on the bottom left of the page.
  10. You can inform a commit message (eg. Translation for episode 26 in French), leave other option unchanged (ensure 'Start a new merge request' is checked), and press the blue 'Commit' button.

  11. Create the Merge Request
  12. After you commited your changes (if you checked 'create a merge request') you should be now on the 'New merge Request' page..
  13. Add a simple title, a description and press the blue 'Create merge request' button on the bottom.

Advanced method using only Git

Note: for pushing commits, you'll need a Framagit account.
Also: Master branch is protected.

If you clicked on this item, you probably already know the workflow:

Create a Branch
git checkout -b YOURBRANCHNAME

Add your files, then commit
git add -A
git commit

Create the Merge Request
git push -u origin YOURBRANCHNAME
A message will appear after pushing; mentioning an URL to invite you to create a Merge Request.

Send the translation by email
  1. Please ZIP back your SVG translated files and your info.json file.
  2. Attach it in a new email to info@davidrevoy.com. Done.

    Note: Please inform me about the episode and the target language in the email, so I know where to commit the files.

Done! Congratulation!

You sent a Pepper&Carrot translation! ๐ŸŽ‰
Thank you for your contribution!

Done

8. F.A.Q.

Q: Where can I subscribe to receive notifications about new episodes ready to be translated?
A: Each time a new episode is ready for translation, I notify all project member on Framagit. Create a Framagit account and become a member of our group to receive this notification.

Q: Is it possible to change the characters' names for a translation?
A: Sure, you can. For the French translation, I kept the english 'Carrot' because the French name "Carotte" is feminine.ย I kept 'Pepper' and didn't use the translation 'Poivre' or 'Poivron' because it sounds like an insult French-speakers may throw at a drunkard, 'Poivrot!'.

Q: When I open a SVG, Inkscape prompt me with a dialog window at start-up "Convert Legacy Inkscape file", what should I do?
A: The one looking like that? Just keep the default option "This file contains digital artwork for screen display. (Choose if unsure)" and then press the OK button.

Q: A sentence doesn't sound good in my language, can I rewrite it?
A: That's ok. The most important is to keep the semantic, the feeling and the information of the story. Adding style and changing the expression of your target language is natural.

Q: Do I need to translate all the episodes to get published on the website?
A: No. Feel free to contribute within your possibilities: you can translate just one episode then try one another later. Take your time. The website is designed to fall back to English if there's no translation available for a given episode. So, you can send episode 01, then one month later send episode 03, 04, 05 in a row, then stop here if you want... or then send all the other episodes. Every contribution is welcome; thank you for your effort and contributions!

Q: Can I translate fictive language, as Klingon, Dothraki, Quenya, Sindarin?
A: Yes and No. Yes because you are free to translate the SVG and publish them on your blog/forum as a cross-over with a fair-use "fan-art" of Copyrighted material. No, if you plan to get this files accepted into the main repository of Pepper&Carrot because it is not Creative Commons compatible. You can read more about it on this thread.

Q: A SVG is missing in the translation folder; at episode four: E04P05.svg!
A: The file is indeed missing on purpose: in the comic this panel is a GIF animation and can't be translated. I had to remove the SVG for this page so the renderfarm ignore computing a translation for this specific case. A special set of rules are applied each time a GIF animation appears in the story. That's why it is a rare situation.