### Documentation
-This website, written with [Jekyll](http://jekyllrb.com/), functions as the documentation portal -- simply run `scripts/build_docs.sh` and view the website at `http://0.0.0.0:4000`.
+This website, written with [Jekyll](http://jekyllrb.com/), functions as the official Caffe documentation -- simply run `scripts/build_docs.sh` and view the website at `http://0.0.0.0:4000`.
We prefer tutorials and examples to be documented close to where they live, in `readme.md` files.
The `build_docs.sh` script gathers all `examples/**/readme.md` and `examples/*.ipynb` files, and makes a table of contents.
cd $ROOT_DIR
# Gather docs from examples/**/readme.md
-rm -r docs/gathered
-mkdir docs/gathered
+GATHERED_DIR=docs/gathered
+rm -r $GATHERED_DIR
+mkdir $GATHERED_DIR
for README_FILENAME in $(find examples -iname "readme.md"); do
# Only use file if it is to be included in docs.
if grep -Fxq "include_in_docs: true" $README_FILENAME; then
# Make link to readme.md in docs/gathered/.
# Since everything is called readme.md, rename it by its dirname.
README_DIRNAME=`dirname $README_FILENAME`
- DOCS_FILENAME=docs/gathered/$README_DIRNAME.md
+ DOCS_FILENAME=$GATHERED_DIR/$README_DIRNAME.md
mkdir -p `dirname $DOCS_FILENAME`
ln -s $ROOT_DIR/$README_FILENAME $DOCS_FILENAME
fi
# Gather docs from examples/*.ipynb and add YAML front-matter.
for NOTEBOOK_FILENAME in $(find examples -d 1 -iname "*.ipynb"); do
- DOCS_FILENAME=docs/gathered/$NOTEBOOK_FILENAME
+ DOCS_FILENAME=$GATHERED_DIR/$NOTEBOOK_FILENAME
mkdir -p `dirname $DOCS_FILENAME`
python scripts/copy_notebook.py $NOTEBOOK_FILENAME $DOCS_FILENAME
done