forked from carpentries-i18n/i18n
-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
19 changed files
with
1,880 additions
and
1,884 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
locale/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,74 @@ | ||
## Information for Maintainers and Administrators | ||
|
||
### To update the GitHub pages lessons with Jekyll | ||
|
||
This assumes a high level of familiarity with Git, GitHub, and how these lessons have been configured. These tools can be used to | ||
update the webpages hosted on the organisation repository or create a hosted webpage on your personal fork. | ||
|
||
Updates to the files can be managed by tracking changes to the PO files and translated lessons | ||
can be viewed on the GitHub repository as Markdown files in the `_episodes` directory | ||
of the respectve lesson repo. It is not necessary to update the webpages for every update to | ||
the translations. This will be managed by lesson maintainers and organisers of the Japanese | ||
language team. | ||
|
||
1. Run `po4gitbook/compile.sh` on updated PO files (commit and push changes to PO files to i18n) | ||
|
||
Note that in order for the lessons to compile the Credit line in the PO files HEADER | ||
"# FULL NAME <EMAIL@ADDRESS>, YEAR." must match the contact details of the "Last-Translator". | ||
Please fill in your details or keep these consistent in order to build the new translated lessons. | ||
|
||
|
||
``` | ||
git add -u po/*ja.po | ||
git commit -m "update PO files" | ||
git push origin ja | ||
``` | ||
|
||
2. Clone the translated lesson repo (to a directory outside the i18n repository) | ||
``` | ||
git clone https://github.com/swcarpentry-ja/git-novice-ja.git | ||
``` | ||
Or pull to your copy of this repo | ||
``` | ||
git pull origin master | ||
``` | ||
|
||
3. Move updated translated files to the cloned translated lesson | ||
``` | ||
rsync -ru i18n/locale/ja/git-novice/* git-novice-ja | ||
``` | ||
|
||
4. Commit and push changes to the translated lesson | ||
``` | ||
git add -u * | ||
git commit -m "update lesson files" | ||
git push origin master | ||
``` | ||
|
||
6. Clone or pull a copy of the original lesson repo (again outside any existing git repos) | ||
``` | ||
git clone https://github.com/swcarpentry-ja/git-novice.git | ||
``` | ||
|
||
Or pull to your copy of this repo | ||
``` | ||
git pull origin gh-pages | ||
``` | ||
|
||
6. Sync changes to (master branch of) the pushed submodule files to the original lesson repository | ||
``` | ||
git submodule foreach git pull origin master | ||
``` | ||
|
||
7. Commit changes to the submodule to the original lesson | ||
``` | ||
git add -u | ||
git commit -m "update Japanese lessons" | ||
``` | ||
|
||
8. Push to the lesson repo (or send a pull request) | ||
``` | ||
git push origin gh-pages | ||
``` | ||
|
||
Jekyll will update the "github.io" webpages once a new commit is pushed (but it will not see new commits to submodules unless these are pulled and committed) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,68 @@ | ||
### Using git | ||
|
||
This repository uses the tool `git` via the command line. On Linux and Mas OS, the `bash` terminal should come pre-installed. `git` may be installed but if not it can be installed as follows: | ||
|
||
- Linux Ubuntu-based distros | ||
|
||
``` | ||
sudo apt-get install git | ||
``` | ||
|
||
- Linux Fedora | ||
|
||
``` | ||
yum install git | ||
``` | ||
|
||
or | ||
|
||
``` | ||
sudo dnf install git-all | ||
``` | ||
|
||
- Linux Install from Debian file | ||
|
||
Download the `.deb` file for your OS from here: | ||
|
||
https://pkgs.org/download/git | ||
|
||
``` | ||
dpkg -i git_2.11.0-3+deb9u4_amd64.deb | ||
``` | ||
|
||
- Linux Build from source | ||
|
||
Download the latest version of git: | ||
|
||
https://github.com/git/git/releases | ||
|
||
or | ||
|
||
https://mirrors.edge.kernel.org/pub/software/scm/git/ | ||
|
||
``` | ||
tar -zxf git-2.0.0.tar.gz | ||
cd git-2.0.0 | ||
make configure | ||
./configure --prefix=/usr | ||
make all doc info | ||
sudo make install install-doc install-html install-info | ||
``` | ||
|
||
- Windows | ||
|
||
Download Git for Windows (Git-Bash) by following the instructions here: | ||
|
||
https://gitforwindows.org/ | ||
|
||
or | ||
|
||
https://git-scm.com/ | ||
|
||
- Mac OS | ||
|
||
Install usiing homebrew (requires Xcode): https://docs.brew.sh/Installation | ||
|
||
``` | ||
brew install git | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
## Importing a lesson for the first time | ||
|
||
If you wish to start a translation of a lesson that has not been translated in your language before, | ||
please follow these instructions. See the instructions below for if your lesson has an exisiting | ||
translation and you wish to submit changes or an update. | ||
|
||
1. Create a "Fork" for this repository on your personal GitHub account. (Click "Fork" in the top right | ||
corner of the `https://github.com/swcarpentry-ja/i18n` webpage) | ||
|
||
2. Clone this repository from your personal account (e.g., GitHubUser). This is your local copy to manage your version of | ||
the translation files. | ||
|
||
``` | ||
cd directory | ||
git clone [email protected]:GitHubUser/i18n.git | ||
cd i18n | ||
``` | ||
|
||
If you already have a fork of translation repository, please pull changes for the current | ||
version from the organisation repository: | ||
|
||
``` | ||
git checkout ja | ||
git remote add swc-ja [email protected]:swcarpentry-ja/i18n.git | ||
git pull swc-ja ja | ||
``` | ||
|
||
|
||
3. Add a submodule for the lessons that you want to translate | ||
|
||
``` | ||
git submodule add https://github.com/swcarpentry/git-novice.git | ||
``` | ||
|
||
4. Run `po4gitbook/update.sh` - That creates/updates the `po` directory with the `.pot` files to use in translations. | ||
|
||
5. Create a `po` file and start translating! | ||
- copy `<file>.pot` to `<file>.<lang>.po`. e.g., | ||
```bash | ||
cd po | ||
cp shell-novice.pot shell-novice.es.po | ||
``` | ||
- Edit the file with your favourite po editor ([PoEdit](http://www.poedit.net), | ||
[GTranslator](https://wiki.gnome.org/Apps/Gtranslator), [Lokalize](https://userbase.kde.org/Lokalize), ...) | ||
Note: | ||
- "`Language`" field is needed to add to the header (at least with gtranslator), the rest is put by the tool. | ||
- "`Language-Team:`" needs the first letter in upper case (e.g., `Es` or `Ja`) | ||
- Create `po/LINGUAS` | ||
- run `po4gitbook/compile.sh` - This creates a `locale/<lang>/<lesson>` tree directory | ||
|
||
This generates a translated version of the lessons. Please do not create a git repository within | ||
this repository. You can copy these files to another repository as described in the | ||
"Guide for Translators" and submit changes to the PO files via Pull Request to GitHub. | ||
|
||
Please note that there are files shared between lesson repositories: | ||
``` | ||
CODE_OF_CONDUCT.md | ||
CONTRIBUTING.md | ||
LICENSE.md | ||
README.md | ||
``` | ||
These will be hosted on the translated Git repository but will not be included in the | ||
webpages once they are generated. Apart from the `README`, these are the same files | ||
between each lesson. Please check that these files have not been already translated | ||
for another lesson. If so you can copy these to ensure they are consistent. | ||
|
||
While these files appear at the beginning of the PO files (since files are sorted alphabetically), | ||
they are not a priority to translate. Please skip to the beginning of the lesson, | ||
following the README. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
# SOME DESCRIPTIVE TITLE. | ||
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER | ||
# This file is distributed under the same license as the PACKAGE package. | ||
# David Perez-Suarez <[email protected]>, 2018. | ||
# David Perez-Suarez <[email protected]>, 2019. | ||
# | ||
msgid "" | ||
msgstr "" | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
# Japanese translation of the Software Carpentry Git Lesson | ||
# Copyright (C) 2018 Software Carpentry Foundation; Japanese Translation Team | ||
# Copyright (C) 2019 Software Carpentry Foundation; Japanese Translation Team | ||
# This file is distributed under the same license as the gitbook package. | ||
# Riku Takei <[email protected]>, 2018. | ||
# Riku Takei <[email protected]>, 2019. | ||
# | ||
msgid "" | ||
msgstr "" | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
# Japanese translation of the Software Carpentry Plotting and Programming in Python Lesson | ||
# Copyright (C) 2018 Software Carpentry Foundation; Japanese Translation Team | ||
# Copyright (C) 2019 Software Carpentry Foundation; Japanese Translation Team | ||
# This file is distributed under the same license as the PACKAGE package. | ||
# Software-Carpentry Japanese-Team <[email protected]>, 2018. | ||
# Software-Carpentry Japanese-Team <[email protected]>, 2019. | ||
# | ||
msgid "" | ||
msgstr "" | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,7 @@ | ||
# Japanese translation of the Software Carpentry Programming with Python Lesson | ||
# Copyright (C) 2018 Software Carpentry Foundation; Japanese Translation Team | ||
# Copyright (C) 2019 Software Carpentry Foundation; Japanese Translation Team | ||
# This file is distributed under the same license as the PACKAGE package. | ||
# Software-Carpentry Japanese-Team <[email protected]>, 2018. | ||
# Software-Carpentry Japanese-Team <[email protected]>, 2019. | ||
# | ||
msgid "" | ||
msgstr "" | ||
|
Oops, something went wrong.