blob: 4aef8602a87fd697fb3d214a8175a690625b2cf2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
#!/bin/bash
# SPDX-license-identifier: Apache-2.0
##############################################################################
# Copyright (c) 2016 NEC and others.
# All rights reserved. This program and the accompanying materials
# are made available under the terms of the Apache License, Version 2.0
# which accompanies this distribution, and is available at
# http://www.apache.org/licenses/LICENSE-2.0
##############################################################################
set -o errexit
set -o nounset
set -o pipefail
set -o xtrace
GIT_CLONE_BASE=${GIT_CLONE_BASE:-ssh://gerrit.opnfv.org:29418}
GERRIT_BRANCH=${GERRIT_BRANCH:-master}
WORKSPACE=${WORKSPACE:-/tmp}
get_repo_names() {
# NOTE: Not all repositories are ready for the composite docs,
# so we have the repo name list here to add project docs
# one by one. This will be replaced by the list in project.cfg .
# grep -v '^#' releng/jjb/opnfvdocs/project.cfg | sort
echo "sdnvpn"
echo "fuel"
echo "ipv6"
echo "joid"
echo "functest"
echo "apex"
echo "promise"
echo "copper"
echo "doctor"
echo "vswitchperf"
echo "fastpathmetrics"
}
git_clone() {
_repo="$1"
[[ -d "$WORKSPACE/$_repo" ]] && return 0
pushd $WORKSPACE
git clone -b $GERRIT_BRANCH --depth 1 --quiet $GIT_CLONE_BASE/$_repo
popd
}
git_clone releng
repos=$(get_repo_names)
[[ -e docs/projects ]] && rm -rf docs/projects
mkdir -p docs/projects
echo
echo "Cloning repos of participating OPNFV Projects and copying docs"
echo
for repo in $repos; do
echo " $repo ($GERRIT_BRANCH)"
git_clone $repo
[[ -e $WORKSPACE/$repo/docs ]] || continue
[[ -e docs/projects/$repo ]] && rm -rf docs/projects/$repo
cp -r $WORKSPACE/$repo/docs docs/projects/$repo
done
# NOTE: Removing index.rst in project repos to reduce number of docs.
find docs/projects -type f -name 'index.rst' -print | xargs -I i rm -f i
# Correct Image file path (workaround)
sed -i -e '/^.. figure::/s|images|../projects/promise/configguide/images|' \
docs/projects/promise/configguide/featureconfig.rst
# NOTE: automated link generation is not ready...
#echo
#echo "Creating document links"
#echo
#for guide in configguide userguide
#do
# link_list=$WORKSPACE/docs/$guide/projects-$guide.rst
# for repo in $repos
# do
# file=projects/$repo/$guide/$guide.rst
# [[ -e $WORKSPACE/docs/$file ]] || continue
# echo "" >> $link_list
# echo "$repo:" >> $link_list
# echo ".. include:: ../$file" >> $link_list
# done
#done
$WORKSPACE/releng/utils/docs-build.sh
echo "Done"
|