Getting the most recent Ghost docs
To start translating you will first need to ‘fork’ the GitHub repository branch to your own account. You can do this by clicking the ‘fork’ button in the top right corner of GitHub.
It looks like this:
You should now be able to access you fork by navigating to
Once you have verified you have a working fork, you will need to download it to your computer. To download the fork to your machine, you will need to follow these steps (in the Terminal / Command prompt);
git clone https://github.com/<your username>/Ghost.git -b gh-pages
You should now be in the Ghost directory in your Terminal / Command Prompt. If you also open the Ghost folder in your directory browser of choice, you will see all the files for the Ghost documentation.
### Adding your translation
After following how to get the most recent Ghost documentation.
- Duplicate the
- Rename the duplicated folder to your appropriate language code (IETF language tag). e.g.
If you're unsure of your language code, feel free to ask on the [forum](http://ghost.org/forum).
- Update all the
lang: example_translationfields at the top of each
.mdfile in your new directory to the same language code as your new directory.
- Update all the
permalink: /example_translation/*fields at the the top of the
.mdfiles that require it (not in all the files), to
permalink: /your_language_code/*. Be sure to keep the content where
*is, the same.
- Add your language and translations to the
_config.ymlfile. Follow the format already present, and remember to use the country code you have used in the above steps.
- Start translating the
.mdfiles in your new directory :)
Submitting your change
- Open the terminal back up, where you should still be in your
git commit -a
- Name your commit message to sensibly reflect your addition / change. (press
ito start typing your message) e.g “Included Welsh translations” or “Updated Welsh ‘usage’ docs”. Save your commit message by pressing
:wq, then press enter.
- Submit your changes to your GitHub fork by running
git push origin gh-pages. This sometimes prompts your for your GitHub username / password - enter those. You should then see some success messages.
- Navigate to your GitHub fork (
- Click on the Pull Request button.
- Enter any additional details that need to be known in the ‘description’ box.
- Submit your Pull Request to the
TryGhost:gh-pagesbranch (should be automatically set).
- That’s it, you’re done. The Ghost team will review it and comment on any additional changes which need to be made.
Updating a translation
To update a translation you can simply follow the steps in “Adding your translation”, but ignoring all the setup and simply changing the required areas, or if you would prefer to follow a simpler alternative you can do it directly in GitHub.
- Locate the file that needs changing in the https://github.com/TryGhost/Ghost/tree/gh-pages repository.
- Click on file
- Click ‘Edit’
- Make your changes
- Add a sensible commit message e.g. “Updated Welsh ‘usage’ docs”
- Add a sensible description e.g. “Fixed a typo in the ‘usage’ docs where …”
- Read over your submission
- Click “Propose this file change”
- Feel good.
Please do not send in translations for Ghost just yet, we are still setting up the best way to do this. We really don’t want to throw away anyone’s work.