diff options
Diffstat (limited to 'Makefile')
-rw-r--r-- | Makefile | 14 |
1 files changed, 4 insertions, 10 deletions
@@ -159,14 +159,14 @@ composer_dependencies: clean | |||
159 | find vendor/ -name ".git" -type d -exec rm -rf {} + | 159 | find vendor/ -name ".git" -type d -exec rm -rf {} + |
160 | 160 | ||
161 | ### generate a release tarball and include 3rd-party dependencies | 161 | ### generate a release tarball and include 3rd-party dependencies |
162 | release_tar: composer_dependencies doc_html | 162 | release_tar: composer_dependencies htmldoc |
163 | git archive --prefix=$(ARCHIVE_PREFIX) -o $(ARCHIVE_VERSION).tar HEAD | 163 | git archive --prefix=$(ARCHIVE_PREFIX) -o $(ARCHIVE_VERSION).tar HEAD |
164 | tar rvf $(ARCHIVE_VERSION).tar --transform "s|^vendor|$(ARCHIVE_PREFIX)vendor|" vendor/ | 164 | tar rvf $(ARCHIVE_VERSION).tar --transform "s|^vendor|$(ARCHIVE_PREFIX)vendor|" vendor/ |
165 | tar rvf $(ARCHIVE_VERSION).tar --transform "s|^doc/html|$(ARCHIVE_PREFIX)doc/html|" doc/html/ | 165 | tar rvf $(ARCHIVE_VERSION).tar --transform "s|^doc/html|$(ARCHIVE_PREFIX)doc/html|" doc/html/ |
166 | gzip $(ARCHIVE_VERSION).tar | 166 | gzip $(ARCHIVE_VERSION).tar |
167 | 167 | ||
168 | ### generate a release zip and include 3rd-party dependencies | 168 | ### generate a release zip and include 3rd-party dependencies |
169 | release_zip: composer_dependencies doc_html | 169 | release_zip: composer_dependencies htmldoc |
170 | git archive --prefix=$(ARCHIVE_PREFIX) -o $(ARCHIVE_VERSION).zip -9 HEAD | 170 | git archive --prefix=$(ARCHIVE_PREFIX) -o $(ARCHIVE_VERSION).zip -9 HEAD |
171 | mkdir -p $(ARCHIVE_PREFIX)/{doc,vendor} | 171 | mkdir -p $(ARCHIVE_PREFIX)/{doc,vendor} |
172 | rsync -a doc/html/ $(ARCHIVE_PREFIX)doc/html/ | 172 | rsync -a doc/html/ $(ARCHIVE_PREFIX)doc/html/ |
@@ -195,17 +195,11 @@ doxygen: clean | |||
195 | @rm -rf doxygen | 195 | @rm -rf doxygen |
196 | @( cat Doxyfile ; echo "PROJECT_NUMBER=`git describe`" ) | doxygen - | 196 | @( cat Doxyfile ; echo "PROJECT_NUMBER=`git describe`" ) | doxygen - |
197 | 197 | ||
198 | ### Convert local markdown documentation to HTML | 198 | ### generate HTML documentation from Markdown pages with MkDocs |
199 | # | 199 | htmldoc: |
200 | # For all pages: | ||
201 | # - convert GitHub-flavoured relative links to standard Markdown | ||
202 | # - generate html documentation with mkdocs | ||
203 | htmlpages: | ||
204 | python3 -m venv venv/ | 200 | python3 -m venv venv/ |
205 | bash -c 'source venv/bin/activate; \ | 201 | bash -c 'source venv/bin/activate; \ |
206 | pip install mkdocs; \ | 202 | pip install mkdocs; \ |
207 | mkdocs build' | 203 | mkdocs build' |
208 | find doc/html/ -type f -exec chmod a-x '{}' \; | 204 | find doc/html/ -type f -exec chmod a-x '{}' \; |
209 | rm -r venv | 205 | rm -r venv |
210 | |||
211 | doc_html: authors htmlpages | ||