gnome-getting-started-docs
==========================

This package contains the Getting Started guide which is packaged and
shipped as gnome-getting-started-docs in the core GNOME distribution.

The GNOME Documentation Project (GDP) is responsible for this documentation.

GDP homepage: http://live.gnome.org/DocumentationProject
GDP mailing list: http://mail.gnome.org/mailman/listinfo/gnome-doc-list

Translators
-----------

Although this guide includes a number of media files (videos, SVGs),
translators just need to translate a single POT file for the Getting Started
guide, which also includes strings extracted from the media files.

Where to get translated videos
------------------------------

As a temporary workaround for https://bugzilla.gnome.org/show_bug.cgi?id=699998,
translated videos are not stored in the Git repository anymore, instead, they
are pulled from an external source at the following URL when releasing a new
tarball:

http://people.gnome.org/~jimmac/gnome-getting-started-docs/

Rendering video files
---------------------

Rendering translated videos is not currently supported at build time. If you
want to have the video files generated for your language, please get in touch
with gnome-getting-started-docs maintainers. The plan is to have the video
files generated for all available languages when releasing a new tarball.

See the animation/language-whitelist.txt file in the gnome-getting-started-docs
repository for a list of languages for which the videos are currently rendered.

Generating SVG files
--------------------

To generate translated SVGs that are used as still images for some topics in
the guide, run the following command in the gnome-getting-started-docs root
directory:

./autogen.sh && make

Then change to the gnome-help/<your_language>/ directory to see your
translated SVGs.

Note that depending on your distribution, you may need to install some
additional packages to run the commands.

Please do not commit the generated SVGs, these files will be regenerated for
all available languages when releasing a new tarball. The .gitignore file is
properly set to ignore these files.

The gs-browse-web.page file
---------------------------

The gs-browse-web.page file contains conditionalized information on both the
upstream default browser Web (Epiphany) and Firefox, which often replaces Web
as the default browser downstream.

See comments in the gs-browse-web.page file for a hint on how to adjust the
file so that the appropriate information is displayed for your downstream
distribution.

Language packs
--------------

Given the size of the video files, distributors might want to create
language packs for individual locales, as the overall package size for
the gnome-getting-started-docs package would be too large otherwise.

Reporting problems
------------------

If you find problems in the documentation, please report bugs:

https://gitlab.gnome.org/GNOME/gnome-getting-started-docs/issues