-
CONTRIBUTING: getting started and general guidance on contributing to https://fortran-lang.org
-
MINIBOOKS: how to write and structure a mini-book tutorial for the Learn section
-
PACKAGES: adding an entry to the Package index
This assumes that you already have a recent version of python For example on Ubuntu 20.04, do:
To install the dependencies of this project, use commamd:
pip3 install --user -r requirements.txt
Build the site by invoking
make html
The website will be built in build/html and can be previewed by opening the page with a browser (e.g. firefox, chromium or similar):
firefox file://$PWD/build/html/en/index.html
By default all languages will be built. To limit the build to a single language subtree, i.e. English, use
make html LANGUAGES=en
The documentation uses the
sphinx-intl
utility to generate websites for multiple languages.
It generates *.po files,
which contain the original sentences and a placeholder for translations.
To update translations run
make gettext
if you only want to update a single translation add LANGUAGES=de to the command.
This command will generate the message catalog (*.pot) and update the *.po files in the locale directory of the respective translations.
Then edit the *.po files,
e.g. locale/de/LC_MESSAGES/index.po.
In the *.po files are paragraphs like
#: ../../pages/index.md:16
msgid "Package manager and build system for Fortran"
msgstr ""The first line describes the file and line where to find the original text.
The second line is the original text. Don't edit this line, edit the original document instead.
The third line is meant for the translation.
To continue a long string in another line,
simply close the string in the current line with "
and open another one in the line underneath. E.g.
msgstr "This is "
"one string"
don't forget a space between 'is' and 'one'
After adding or updating translations build the documentation as described above.
This project is free software: you can redistribute it and/or modify it under the terms of the MIT license.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an as is basis, without warranties or conditions of any kind, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this repository by you, shall be licensed as above, without any additional terms or conditions.