FancyGoldfish07 / localized_docs

Localized documentation

phpMyAdmin - localized documentation

This repository contains localized documentation for phpMyAdmin. It is based on master document placed in phpmyadmin repository.

To translate edit your language file in po directory, changes will be propagated to generated documents. You can also translate online at <https://hosted.weblate.org/projects/phpmyadmin/documentation/> and your changes will be merged to Git.

Requirements

For manipulating with translations, you need gettext and sphinx installed.

Usage

To start new translation just add it to the Makefile.

To regenerate mofiles run:

make

To obtain statistics about current translations run:

./locales-stats

To update documentation run:

# Force Weblate to commit changes, requires wlc to be installed
wlc commit
# Pull changes from Weblate
git pull
# Update phpMyAdmin submodule
git submodule update --remote
# Update po files to match current docs
make

This automatically updates po files, generates mo files and synchronizes sources of the documentation. Review changes and commit them using:

git commit -a -m 'Update documentation to match master'

To build documentation in given language (for example Czech):

make html-cs

You can also invoke sphinx-build manually:

sphinx-build docs/cs/ output/cs/

You can also build all documentation at once:

make html

You can also browse translated documentation online at <https://docs.phpmyadmin.net/>.