The glossary is imported automatically from openstack-manuals, no need
to test that it is sorted as this is done in openstack-manuals already.
Change-Id: If57bda8c5f83d7c833387f0c6ee7ea570d785dac
This restores the content of the repo to include all changes that
were done while the content was moved to the openstack-manuals
repo. There were also some updates and fixes to get the content
to build and pass jobs with the current doc job definitions.
Change-Id: Ic05b44a210a93667490096cffc8f2e45575ffb34
Retire repository following the process on retiring an OpenStack
repository:
http://docs.openstack.org/infra/manual/drivers.html#remove-project-content
This removes *all* content and just leaves a single README.rst that
explains how to get it.
Change-Id: I36ca5788dbc3e44b5421b88e64972585f8820947
Depends-On: I9f4e21b44c717d11511fea48db54a52103e294b1
After https://review.openstack.org/#/c/144685 merges,
the automatically generated configuration reference
tables will be marked up as
<option>option_name</option> = <replaceable>default_value</replaceable>
As none of this should be translated (option_name is the same
regardless of language), this patch updates generatepot to ignore
option_name s tagged with <option> for translation.
This should significantly reduce the number of strings required for
translation from the common directory in particular, where
many of the 8000-odd strings do not actually need translation.
Change-Id: I093056c182bf0bb3ca79892b66f1e9239a323da1
We have git to track the authorship of files. It is not necessary to use
the @author tags in the copyright statements.
Change-Id: I66572547c5532965cd3ae356bc9e297e71e13f2c
This allows sharing of glossary and its translation between the various
documentation repositories.
Also import locale files and just test-languages.sh.
implements bp common-glossary-setup
Change-Id: I01d68f29d5a4e713e17ed88815644ad40f98bf71
Rework test-languages so that we can test *all* languages as well
if needed and use the same script for both buildlang and testlang.
Add new tox job "publishlang" to publish all languages at once.
Change-Id: Ia8abe50ae798887ed62eaa8c81a4c7472021f718
The generatepot script used to generate POT files for translation
still used an old pre-restructure path.
This patch fixes to use the new path "doc".
Change-Id: I424f8b8f6c38a0b08f80fc0e72d3cd52785abba5
Closes-Bug: #1275596
This is a small change primarily to test the
openstack-operations-guide-ja build job. It mirrors
a similar change to openstack-doc-tools, which should
deprecate this tools directory.
Change-Id: I14c385e71d3ac4fa9f922d84048ee20f6198c6a0
tools/generatepot uses Docbook XML mode.
It replaces elements of several types with placeholder.
eg: <command>ps aux</command> -> <placeholder-1>
[aaa.xml]
run <command>ps aux</command>.
[aaa.pot]
msgid "run <placeholder-1>."
msgstr ""
Then, translatores translate strings with placeholder.
eg: [ja.po]
msgid "run <placeholder-1>."
msgstr "<placeholder-1> wo jikkou."
So, tools/generatedocbook need to merge the tranlation strings,
considering Docbook format.
If not be considered, the strings containing a placeholder
element remains untranslated because msgid does not match.
eg: [aaa.xml]
run <command>ps aux</command>.
[ja.po]
msgid "run <placeholder-1>." <- not match
msgstr "<placeholder-1> wo jikkou."
Change-Id: Ieb32ed8bfb0b6880040e47e3700b812f81598d8a
This patch added tools used for slicing and merging in translation process.
The patch also includes the POT files for each documents.
The PO files are not included, which can be downloaded from Transifex.
Fixes: bug #1153415
Change-Id: Ia455134c99acb1129e8f10deda0d85867b1ef9a3
With this patch, running the tools/validate.py script will return
no DocBook RelaxNG schema validation failures.
Once this patch lands, and the equivalent lands in stable/folsom,
I will follow up on getting this run automatically by Jenkins so
we can see the results when there are new doc patch proposals.
There were three XML validation failures that were addressed
openstack-compute-admin/rootwrap.xml:
rootwrap.xml had to xml:id values that were the same. These have
been changed so they are different. It turns out this file was not
being included in the documentation at all. I submitted a separate
patch to include it: https://review.openstack.org/20551
openstack-compute-admin/computeconfigure.xml:
computeconfigure.xml had xi:include elements with an 'os' attribute.
This violates the spec, and it doesn't work, either. We had two
lines that looked like this:
<xi:include os="ubuntu" ...>
<xi:include os="rhel;fedora;centos" ...>
and both files were being included in the docs. This was changed so
that only one file is included, and there's a note that has been
added that describes the difference between the two files, which
is very minor (just one parameter).
openstack-ha/ha-guide-docinfo.xml:
This isn't a real XML file, it's a fragment of XML that is used
by a non-standard toolchain. The validation script has been configured
to just ignore it for now.
Change-Id: Ie77218efc56c16b7bf162f5e02fd7a6d99116dc1
Adds a script called tools/validate.py that will check all XML
files against the DocBook 5 RELAX NG schema.
Does not check pom.xml files or files inside of directories named
"target".
Change-Id: I9614f1b10ac2da608a245c7644309a5be38c8995