2 # SPDX-license-identifier: Apache-2.0
3 ##############################################################################
4 # Copyright (c) 2016 NEC and others.
5 # All rights reserved. This program and the accompanying materials
6 # are made available under the terms of the Apache License, Version 2.0
7 # which accompanies this distribution, and is available at
8 # http://www.apache.org/licenses/LICENSE-2.0
9 ##############################################################################
16 GIT_CLONE_BASE=${GIT_CLONE_BASE:-ssh://gerrit.opnfv.org:29418}
17 GERRIT_BRANCH=${GERRIT_BRANCH:-master}
18 WORKSPACE=${WORKSPACE:-/tmp}
21 # NOTE: Not all repositories are ready for the composite docs,
22 # so we have the repo name list here to add project docs
23 # one by one. This will be replaced by the list in project.cfg .
24 # grep -v '^#' releng/jjb/opnfvdocs/project.cfg | sort
28 echo "fastpathmetrics"
41 [[ -d "$WORKSPACE/$_repo" ]] && return 0
43 git clone -b $GERRIT_BRANCH --depth 1 --quiet $GIT_CLONE_BASE/$_repo
49 repos=$(get_repo_names)
51 [[ -e docs/projects ]] && rm -rf docs/projects
52 mkdir -p docs/projects
55 echo "Cloning repos of participating OPNFV Projects and copying docs"
57 for repo in $repos; do
58 echo " $repo ($GERRIT_BRANCH)"
60 [[ -e $WORKSPACE/$repo/docs ]] || continue
61 [[ -e docs/projects/$repo ]] && rm -rf docs/projects/$repo
62 cp -r $WORKSPACE/$repo/docs docs/projects/$repo
65 # NOTE: Removing index.rst in project repos to reduce number of docs.
66 find docs/projects -type f -name 'index.rst' -print | xargs -I i rm -f i
68 # Correct Image file path (workaround)
69 sed -i -e '/^.. figure::/s|images|../projects/promise/configguide/images|' \
70 docs/projects/promise/configguide/featureconfig.rst
72 # NOTE: automated link generation is not ready...
74 echo "Creating document links"
77 configguide/installer-config.rst
78 configguide/feature-config.rst
80 # configguide/postinatall.rst
81 # userguide/feature-usage.rst
82 # userguide/test-usage.rst
85 mainfile="$WORKSPACE/docs/$guide"
86 basefilename=$(basename ${guide/-/})
89 targetfile="$WORKSPACE/docs/projects/$repo/${guide/-/}"
90 targetlink="../projects/$repo/${guide/-/}"
91 projectfilename="${basefilename/.rst/-$repo.rst}"
92 projectfile="$(dirname $mainfile)/$projectfilename"
93 [[ -e "$targetfile" ]] || continue
94 echo "Adding $repo to $guide ..."
96 echo ".. toctree::" >> $mainfile
98 echo " $projectfilename" >> $mainfile
99 echo ".. include:: $targetlink" > $projectfile
102 echo "Generated $guide:"
107 $WORKSPACE/releng/utils/docs-build.sh