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 ##############################################################################
11 GIT_CLONE_BASE=${GIT_CLONE_BASE:-ssh://gerrit.opnfv.org:29418}
12 GERRIT_BRANCH=${GERRIT_BRANCH:-master}
13 WORKSPACE=${WORKSPACE:-.}
16 # NOTE: Not all repositories are ready for the composite docs,
17 # so we have the repo name list here to add project docs
18 # one by one. This will be replaced by the list in project.cfg .
19 # grep -v '^#' releng/jjb/opnfvdocs/project.cfg | sort
25 echo "fastpathmetrics"
42 [[ -d "$WORKSPACE/$_repo" ]] && return 0
44 git clone -b $GERRIT_BRANCH --depth 1 --quiet $GIT_CLONE_BASE/$_repo
48 repos=$(get_repo_names)
50 [[ -e docs/projects ]] && rm -rf docs/projects
51 mkdir -p docs/projects
54 echo "Cloning repos of participating OPNFV Projects and copying docs"
56 for repo in $repos; do
57 echo " $repo ($GERRIT_BRANCH)"
59 [[ -e $WORKSPACE/$repo/docs ]] || continue
60 [[ -e docs/projects/$repo ]] && rm -rf docs/projects/$repo
61 cp -r $WORKSPACE/$repo/docs docs/projects/$repo
64 # NOTE: Removing index.rst in project repos to reduce number of docs.
65 find docs/projects -type f -name 'index.rst' -print | xargs -I i rm -f i
67 # fix relative file paths
68 pattern='.. \(include\|figure\):: *[^ \/]'
69 base_path="/$(pwd)/docs_build/_src"
70 find docs/projects -type f -name '*.rst' -print | while read f
72 sed -i -e "/$pattern/s|:: *|:: $base_path/$(dirname ${f#docs/})/|" $f
76 grep -e '.. include::' -e '.. figure::' -r docs/projects
78 # NOTE: automated link generation is not ready...
80 echo "Creating document links"
83 configurationguide/configuration.options.render.rst
84 configurationguide/scenario.description.rst
85 userguide/feature.userguide.render.rst
86 testframework/framework.installation.procedure.render.rst
87 testframework/framework.userguide.render.rst
89 # configurationguide/post-install.rst
92 mainfile="$WORKSPACE/docs/$guide"
93 basefilename=$(basename ${guide/-/})
96 targetfile="$WORKSPACE/docs/projects/$repo/${guide/-/}"
97 targetlink="../projects/$repo/${guide/-/}"
98 projectfilename="${basefilename/.rst/-$repo.rst}"
99 projectfile="$(dirname $mainfile)/$projectfilename"
100 [[ -e "$targetfile" ]] || continue
101 echo "Adding $repo to $guide ..."
103 echo ".. toctree::" >> $mainfile
105 echo " $projectfilename" >> $mainfile
106 echo ".. include:: $targetlink" > $projectfile
109 echo "Generated $guide:"