Last active
February 19, 2018 09:26
-
-
Save daknuett/5af9f127949732ea775879e1c6f45070 to your computer and use it in GitHub Desktop.
A simple Makefile to make sphinx html suit github-pages
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# Using github-pages with sphinx-build documentation | |
# is a pain in the ass. | |
# This makefile solves the problems quickly. | |
# just add these lines to the "html" rule that sphinx-quickstart | |
# generated and save this file with the name github-make in | |
# the folder that contains your sphinx-Makefile: | |
# | |
# @echo "Copying files to /docs..." | |
# if [ -e ../docs ] ;then rm -rf ../docs;fi | |
# cp -r $(BUILDDIR)/html ../docs | |
# @echo "done" | |
# @echo "calling postbuild..." | |
# cp github-make ../docs/Makefile | |
# cd ../docs && make github | |
# @echo "done" | |
# | |
# then the command "make html" will build a | |
# site suiting github-pages in ../docs | |
# ~Makefile~ | |
github: | |
find . -name \*.html -exec sed -i -- 's/_static/static/g' {} \; | |
find . -name \*.html -exec sed -i -- 's/_sources/sources/g' {} \; | |
find . -name \*.html -exec sed -i -- 's/_images/images/g' {} \; | |
find . -name \*.html -exec sed -i -- 's/_modules/modules/g' {} \; | |
if [ -e _static/ ] ; then mv _static/ ./static/; fi | |
if [ -e _sources/ ] ; then mv _sources/ ./sources/; fi | |
if [ -e _images/ ] ; then mv _images/ ./images/; fi | |
if [ -e _modules/ ] ; then mv _modules/ ./modules/; fi |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
In this version I fixed the messed up
find
usage.