summaryrefslogtreecommitdiffstats
path: root/utils/docs-build.sh
AgeCommit message (Collapse)AuthorFilesLines
2016-01-07docs-build.sh: fix merging of top level docsRyota MIBU1-1/+10
Change-Id: I6d489be3631fa81e799b55cce9d9e3d1c2608140 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2016-01-07fix build directory for OPNFV docsRyota MIBU1-16/+18
Apex has own 'build' directory which is not for docs and contains valid files. This patch fix build dir name from 'build' to 'docs_build' to avoid the conflict. 'output' dir name is also changed to 'docs_output'. Change-Id: I0eb047bfb9c8b85016ce82844915e60538e4d2a8 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-12-22fix docs-build.sh bug in rst checksRyota MIBU1-9/+12
After [1] merged, docs-build.sh cannot check and edit rst files to add revision into source files. Build error can be found in [2]. This patch fixes this bug. [1] https://gerrit.opnfv.org/gerrit/#/c/4659 [2] https://build.opnfv.org/ci/job/opnfv-docs-verify-master/211/console Change-Id: I506d85341d665a1e2c854ab5965ef3abffa31446 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-12-22Merge "fix doc-build.sh to support referring to other dirs"Ryota MIBU1-10/+13
2015-12-21Allow doc-build.sh to ignore D000 of doc8Ryota MIBU1-1/+1
http://lists.opnfv.org/pipermail/opnfv-tech-discuss/2015-December/007286.html Change-Id: Icfdb356566918b7d5c55fbf5eb24b4c8570d32f4 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-12-17fix doc-build.sh to support referring to other dirsRyota MIBU1-10/+13
In [1], we found that current doc-build.sh cannot create document when the main index.rst referring to rst file in another folder. The reason is current script only copies target src folder under the working directory. This patch fix this bug by making doc-build.sh to copy all src files in the original directory structure. Then, all file links (import) can work properly. Error message for '_sha1_' is modified to drop directory info, but developer can find a bad file path from grep output. [1] https://gerrit.opnfv.org/gerrit/#/c/4353 Change-Id: I1d840b8a887306539f97321570f289ac25055a88 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-12-16update doc-build.sh to allow multiple depth of dirRyota MIBU1-1/+34
In our new documentation guideline, we suggest to create documentation directory just in one depth from top 'docs' directory. This rule can make sure there is no name collision. However, some projects are already using multiple depth of documentation directories. So, let's allow them to create their documents without any namespace collision by creating unique names from directory path. Change-Id: I7806abd00be56b0a4811b3d17216495e11bca825 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-12-14Adding doc8 check against rst filesRyota MIBU1-0/+22
This patch adds checks for trailing whitespace or length (> 120) in rst files. If there is any violation, the result will be posted on gerrit as jenkins comment, but won't turn the job failed. JIRA: RELENG-26 JIRA: RELENG-27 Change-Id: I9261e3d91921877a95eafe0a650d8da46304ef40 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
2015-11-30update builder script and how-to-use-docsRyota MIBU1-0/+124
Change-Id: Ia65ebe61c174dc4129d32148d71505c2a2caf480 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>