From 6da4a0356a8eabc4f601b9378800801f1a43b93c Mon Sep 17 00:00:00 2001 From: Holger Wansing Date: Sat, 21 Dec 2019 20:38:40 +0100 Subject: Update docs (things have changed in the meantime) --- doc/translations.txt | 90 ++++++++++++++++++++++++++++------------------------ 1 file changed, 48 insertions(+), 42 deletions(-) (limited to 'doc/translations.txt') diff --git a/doc/translations.txt b/doc/translations.txt index 4ea383b1a..39fdb92a6 100644 --- a/doc/translations.txt +++ b/doc/translations.txt @@ -2,7 +2,8 @@ Debian Installation Guide - notes for translation -------------------------------------------------- !!! Please note, that this file mostly documents xml-based -!!! translations. This is, however, no longer supported. +!!! translations. This is, however, no longer supported and therefore this +!!! file is partly of-out-date. !!! Thus, some of the scripts mentioned below no longer work as expected! !!! You can now translate this manual via po files. !!! This is documented in the file translations_po.txt in this directory. @@ -11,19 +12,63 @@ Debian Installation Guide - notes for translation Note: if you happen to modify this file, please don't forget to update the trailing changelog + Where is the manual kept? ========================= The manual is kept in a git repository on salsa.debian.org -as part of the Debian Installer (d-i) project. +as part of the Debian Installer (d-i) project (under +https://salsa.debian.org/installer-team/installation-guide). -The manual and its translations can be found in ./installation-guide. +The translations can be found in ./po. Use 'git clone git@salsa.debian.org:installer-team/installation-guide.git' to checkout the sources with git. +How to get write access to the git repository +============================================= + + 1) Installing git + ------------------------ + + You need to install subversion on your system. Just do + apt install git + + 2) Getting write access to the git repository + ---------------------------------------------------- + + If you are not a Debian Developer, you first need to create a guest account + on https://salsa.debian.org/, than ask on debian-boot@lists.debian.org + for somebody to add your guest account to the debian-installer project. + + 3) Using git to get files + -------------------------------- + + Once your account is allowed to write to the project, you can retrieve the + installation-guide using this: + git clone git@salsa.debian.org:installer-team/installation-guide.git + + 4) Commit your changed translation files to git + ----------------------------------------------- + + After you have finished editing your translation, use + git add path-to-file(s) + git commit -m "Your comment about this commit" + git push + to commit your changes to the git repository. + + +How to get help +=============== + +If you need further assistance, feel free to ask for help on +debian-boot (for debian-installer related stuff) or debian-i18n (for +l10n related questions) Debian mailing lists. + + + How to join the translation effort for an existing translation ============================================================== @@ -224,45 +269,6 @@ You can also try to build the manual (create HTML pages) for a specific architecture for your language. See ./build/README for more information on building the manual. -How to get write access to the git repository -============================================= - - 1) Installing git - ------------------------ - - You need to install subversion on your system. Just do - apt install git - - 2) Getting write access to the git repository - ---------------------------------------------------- - - If you are not a Debian Developer, you first need to create a guest account - on https://salsa.debian.org/, than ask on debian-boot@lists.debian.org - for somebody to add your guest account to the debian-installer project. - - 3) Using git to get files - -------------------------------- - - Once your account is allowed to write to the project, you can retrieve the - installation-guide using this: - git clone git@salsa.debian.org:installer-team/installation-guide.git - - 4) Commit your changed translation files to git - ----------------------------------------------- - - After you have finished editing your translation, use - git add path-to-file(s) - git commit -m "Your comment about this commit" - git push - to commit your changes to the git repository. - - -How to get help -=============== - -If you need further assistance, feel free to ask for help on -debian-boot (for debian-installer related stuff) or debian-i18n (for -l10n related questions) Debian mailing lists. -------------------------------------------------------------------------- -- cgit v1.2.3