doc: minor cleanup

* Make external links translatable.
  If we use a separate-style of external links, link labels cannot be
  translated, as they are used as label IDs.

* The new openstackdocstheme add version number on the left-top corner.
  However, I18n project has no release, so the version, so the version
  number has no meaning. There is no need to specify 'version' in
  doc/source/conf.py.

Change-Id: I92c91bc39a079be2833a22527683b9c8bc477324
This commit is contained in:
Akihiro Motoki 2017-07-27 23:19:10 +00:00
parent ced2a0467e
commit c2026ab88c
2 changed files with 13 additions and 14 deletions

View File

@ -63,9 +63,9 @@ copyright = u'2015, OpenStack contributors'
# built documents.
#
# The short X.Y version.
version = '1.0.0'
# version = '1.0.0'
# The full version, including alpha/beta/rc tags.
release = '1.0.0'
# release = '1.0.0'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.

View File

@ -11,8 +11,10 @@ The I18n team welcomes any kinds of contribution.
Translations
------------
To help with translation, :doc:`become an official translator <official_translator>`
and join your language team. Then go to `translation website`_ to start translation.
To help with translation,
:doc:`become an official translator <official_translator>` and join your
language team. Then go to
`translation website <https://translate.openstack.org/>`_ to start translation.
You can find prioritized translation jobs as I18n team at the top of the page.
:doc:`Your language team <lang_team>` may have useful information to help our
@ -30,20 +32,17 @@ Fixing I18n bugs
If you want to help fix I18n bugs of OpenStack,
we can find them in the following places:
* `openstack-i18n in Launchpad`_
* `Horizon I18n bugs`_
* `openstack-i18n in Launchpad <https://bugs.launchpad.net/openstack-i18n>`_
* `Horizon I18n bugs <https://bugs.launchpad.net/horizon/+bugs?field.tag=i18n>`_
Translation tools
-----------------
Go to the `translation tools`_ page to understand the tools
and scripts which support our translation platform.
Go to the `translation tools <https://wiki.openstack.org/wiki/I18n/Tools>`_
page to understand the tools and scripts which support our translation
platform.
If you want to help to report bugs, add more wishlists, and improve them,
you can report and fix bugs at `openstack-i18n in Launchpad`_.
you can report and fix bugs at
`openstack-i18n in Launchpad <https://bugs.launchpad.net/openstack-i18n>`_.
Mark bugs with a tag "tools".
.. _`translation website`: https://translate.openstack.org/
.. _`openstack-i18n in Launchpad`: https://bugs.launchpad.net/openstack-i18n
.. _`translation tools`: https://wiki.openstack.org/wiki/I18n/Tools
.. _`Horizon I18n bugs`: https://bugs.launchpad.net/horizon/+bugs?field.tag=i18n