* since training-guides repo is not so frequently updated,
publish the translated guides with the original guide.
* also, remove the unnecessary tox environment.
Change-Id: I8b413d7e8343e661e3d1bdeb5db8b58fa07c0e29
Upstream training is currently published as draft. Enable publishing as a
regular content on docs.openstack.org/upstream-training.
Change-Id: I9efa7918d84acd7d637f063b3ef8b07291072c15
Adds a new openstackdocs themed landing page for Upstream training. Renames
old landing page to slide-index.html (so users that prefer slide-only landing
page can still use it).
Change-Id: I8575af8e5b70940e5252c86e8c584261e0e29ab4
Closes-Bug: #1494724
Start publishing training gudies to draft. This also
enables preview during the review on the gerrit interface.
Change-Id: Ibd7090f6ce130fbec73586acece223f81b120122
Create publishbuild and checkbuild targets so that the upstream-training
slides will be gated and published at
http://docs.openstack.org/draft/upstream-training
Change-Id: I2ad3736cbd5e66d07bb84ffb9f805a0270663f7b
- delete landslide files
- convert existing rst files to Hieroglyph format
- add new slide build command to the tox.ini
- change default CSS to make output more OpenStack-like
- used the Foundation Slides' OpenStack-Powered-April2015.ppt
- title slide with image
- white h1 css text
- "openstack's special red" for h2
Change-Id: Icb22482862a85c3d174d9292fb470f64fb95f7aa
Updates bashate checks to cover the labs folder more throughly and
also omit all other possible files.
Change-Id: I9ad1ef55b54351e21175db8bb08bc44526e952e9
Update the current gate 'slides' to build and publish upstream
training content. This patch does the following changes.
* Adds generateslides script to use sphinx/hieroglyph to build slides
* Updates tox.ini to use generateslides script
* Update .gitignore to ignore _build/ directory which is the default
folder for generated output generated by sphix.
Hence forth, any changes to the upstream training rst slides will be
gated and published, also it is essential to note that these jobs are
new and may not be accurate or reliable to address all the errors in
the rst slides.
Change-Id: I8a220dd31501f9b3733a6282d7048fe283d2a0d1
- rename tox option for building upstream slides only (useful when "debugging"
slide content and appearance), adds doc8 syntax checking
- update ignore-path for doc8 (include also the (future) build directory for
the training guides)
Change-Id: I112f4f20f676e369f7369ed036b14464862ea3ef
modifided tox.ini and requirements.txt to install
hieroglyph, added some changes in the styles
of the individual .rst files to support hiero
Change-Id: Id2674e593857470cf4efa0706a4fbda33813f374
Address the change from XML to RST, XML based jobs are disabled. Current
content in Juno release for training guides is not going to include any
XML Docbook content. This patch disables the XML related jobs.
This patch will be followed by more jobs added to build RST content to
HTML and PDF format as required using the tools decided by the team. The
jobs disabled will be re-enabled with the appropriate set of tools.
Deletes all the jobs which are not required. Addresses changes done by
https://review.openstack.org/#/c/152118.
Change-Id: I91727929fe19dbc7487f2719cdba80157c543d6b
Add slides tox environment for building RST based slides. This tox
environment needs to be enhanced moving forward. For now it includes
the doc8 test to test RST and txt files. Also setup doc8 testing.
Change-Id: I76e0d235b9ee89c8de8033a7119e34cbcf1f0ddd
This changeset reverts "labs: temporary wbatch fix" and replaces it with
a proper fix, allowing the creation of correct Windows batch files on
build hosts without VirtualBox.
Change-Id: Iad005ce9f0dcecb910fc09b2c43385dd42992eda
The Windows batch files created on the build host have a defect. This
patch should produce zip files with correct scripts until we have a
proper fix.
Change-Id: I9563bd6374d8e020dea29f300fab9c618f3e1987
Our documentation tools are not python3 compatible, so make sure that
tox creates python2 virtual environments during tests.
Change-Id: I86f160fb952ebce8abbac166fe43aae0e7d57005
Generate Windows batch files using osbash.sh and create a zip archive
of the labs directory (for Windows users).
Change-Id: I98005cb390f80ec1681914be041084dfa737ffa5
Makes required directories since they are not created by the doc tools
if only *.po/*.pot files in locale directories are touched.
Change-Id: Iaa206a414f29972f4b627a2cc3a29b52ff85cc25
Generates tar files for labs section for those who want to run the
lab scripts without having to install git and cloning the entire
repository.
Change-Id: I48056f3195b43dec0e15152ee1777b936e29a24d
Setup the same way the other repos are setup.
Note that currently no jobs are run since training-guides has no
localization. But let's keep the setup in sync.
Change-Id: I7e9ced06c3ad9997d7f790a5a4d507fa13ef0490
This is a new non-voting job that will be used for changes of the
manual. It checks that URLs in the manual are reachable and valid.
Change-Id: Iaa9c3f0285aee900f3f51a10669904d72e1113b7
Note that this does not build any translated guides yet since we do not
have the guides translated properly into any language.
This infrastructure is needed to enable the translations.
Change-Id: I2accb7e713ed88a3e06edca31bb7691d2d0bc14c
The training-guides tox.ini was inherited from openstack-manuals
which merges static content from its www directory into its
publish-docs folder.
training-guides doesn't have a www directory -- it shares the static
content with openstack-manuals (they both publish into the same web
root).
Trying to copy files from a non-existent directory results in failure
which in turn prevents training-guides from publishing its manual.
This patch removes from tox.ini the commands that try to copy the
content of the www directory.
Closes-Bug: 1312764
Change-Id: I43f56523a7fe59d2d9ea92cabfcb4e926e751f6d
