1
0
Fork 0
Commit Graph

64 Commits

Author SHA1 Message Date
Wilfried Goesgens c46229f1be Fix testing - we no longer need to crawl the source. 2016-01-12 20:03:25 +01:00
Wilfried Goesgens e0b3203e4d we have filenames with numbers in them, fix the match regexp. 2015-12-14 13:17:00 +01:00
Wilfried Goesgens 8d31426eb3 Move python scripts into the scripts directory 2015-12-09 00:00:49 +01:00
Wilfried Goesgens a5aeadfe33 Add a way to only generate _one_ file 2015-12-08 15:33:37 +01:00
Jan Steemann c6d9f9532d turn off link checking 2015-12-08 12:42:03 +01:00
Wilfried Goesgens e0f29a57c5 Remove whitespaces that may irretate our parser, add checks. 2015-12-04 15:17:36 +01:00
Wilfried Goesgens b36c7890d3 One more filter while checking for dangling references 2015-12-03 16:00:10 +01:00
Wilfried Goesgens c16fead941 Use egrep here too. 2015-12-01 16:35:33 +01:00
Wilfried Goesgens 2825ad6068 Only grep for .md files while checking links. 2015-11-30 11:21:22 +01:00
Wilfried Goesgens d04c609a90 Add checker for direct directory access links without document 2015-11-27 13:45:51 +01:00
Wilfried Goesgens ae17c86a80 Add checker for relative .html links 2015-11-27 13:23:32 +01:00
Wilfried Goesgens aae19ff291 Fix dangling anchors and add checker script to the make target. 2015-11-26 18:51:39 +01:00
Wilfried Goesgens eb75c12bb2 Newer Versions of gitbook put in the source document. Exclude these lines from our sanity checks. 2015-11-03 11:27:59 +01:00
Wilfried Goesgens aa12514b5c Fix links; currently links in REST-documentation only work in the RESTDESCRIPTION :-( 2015-10-01 13:30:55 +02:00
Wilfried Goesgens 17f1b316dd Add checker for MarkdownPP failures; fix existing failures (fixes #1497)
MarkdownPP fails on broken ``` code sections.
2015-09-17 17:26:01 +02:00
Wilfried Goesgens b06d03e84f Cleanup documentation for remaining @-tags 2015-09-17 11:15:33 +02:00
Wilfried Goesgens 70a2c74c1b Update RESTAPI documentation handling to work with the swagger 2 api
- use the structures from the swagger for post / reply structures
  - add missing documentation snippets to their respective places
  - fix syntax of documentation blocks
2015-09-16 16:35:13 +02:00
CoDEmanX 8aa78dcb7f Fix some more typos 2015-09-05 17:18:04 +02:00
Willi Goesgens 2ba7863592 .md links should be replaced by .html during the processing, if not, they're dangling links. 2015-09-04 09:48:05 +02:00
Willi Goesgens 11a8b1841b Restructure Documentation to reduce the number of top list items
- combine HTTP-API Bulk interface descriptions and the tools that use them in an new top-level point 'Bulk Import/Export'
  - add information about the arangosh db-object implementation
  - add information about the arangod db-object implementation (fixes #1223)
2015-09-03 14:44:45 +02:00
Jan Steemann d8c83a02b3 don't include bogus files when checking duplicate documentation blocks 2015-09-03 13:07:14 +02:00
Willi Goesgens 77c97199f2 We need to copy the pngs, else later build steps will only contain possibly invalid symlinks to them. 2015-08-31 14:33:35 +02:00
CoDEmanX 23db2af78a Improvements to documentation building
Fix sed parameter error that creates additional files on Windows/Cygwin, support Python 2.6, fix font for deprecated summary entries and add author/description to book.
2015-08-22 04:18:02 +02:00
CoDEmanX 183adccbd9 Make version more prominent in documentation
Many ebook readers (and reading apps) generate covers from meta data like the book title. Therefore it makes sense to place the version string there instead of the first paragraph.
2015-08-21 00:18:32 +02:00
Willi Goesgens 6b575c96d9 Add the version into the body of the document, since the header isn't rendered into pdf & ebook. 2015-08-20 14:34:25 +02:00
Willi Goesgens 4797b81f44 fix creation / copying of static files 2015-08-14 14:46:57 +02:00
Willi Goesgens b20b58f62e Enable check-docublocks. 2015-08-13 18:55:17 +02:00
Willi Goesgens 0486ab8017 Fix check-summary target, and re-enable it 2015-08-13 16:12:57 +02:00
Willi Goesgens 080ef2ccf0 Work on the check-docublocks target
- include more temporary files from processing
2015-08-13 15:41:32 +02:00
Willi Goesgens c07ede6230 fix installation procedure for included images. 2015-08-11 16:07:34 +02:00
Willi Goesgens 3c988dc7f1 fix parts of the check-docublocks target to work with the new inline samples.
However, its not yet clean, since its primary conditions still aren't met.
2015-08-11 14:16:28 +02:00
Willi Goesgens 6fdb550a60 Fix directories & orders 2015-08-06 15:39:19 +02:00
Willi Goesgens 80a43d30a1 Rework documentation generation process
- remove bot.py, its done now in generateMdFiles.py
  - remove make file target that calls python markdownPP for each file
  - add generateMdFiles.py that now
    - iterates over all files to be processed
    - runs markdownPP as a module for it
    - runs the codeblock replacer
  - sort per book make targets
  - bisect intermediate files into a temporary directory: ppbooks; this simplifies cleaning dramatically.
2015-08-06 13:20:35 +02:00
Thomas Schmidts 1ae27459f9 Added Version-number to the documentation 2015-08-04 11:42:03 +02:00
Willi Goesgens 9899ddf03c Add recommendations about using date time in collections; fixes #1400 2015-07-03 09:30:14 +02:00
Thomas Schmidts 688f18c612 Added images to a new folder on the arangodb server 2015-06-08 18:31:52 +02:00
Thomas Schmidts f5f0d3ece8 Added new header to the Documentation 2015-06-08 18:06:08 +02:00
Willi Goesgens e2b741b402 Add one more test from the automatic Thomas which searches for leftover markdown in the HTML. 2015-05-26 18:36:01 +02:00
Thomas Schmidts d9d0b57504 Added a Blacklist for files in Summary that can be ignored 2015-05-26 16:18:47 +02:00
Willi Goesgens 5c7fc984cf - Move sanity checks into own target
- find proper place to hook in check-summary
2015-05-26 16:10:55 +02:00
Thomas Schmidts a7c9119ec3 Removed duplicate output in the Makefile for the Documentation 2015-05-26 11:40:01 +02:00
Thomas Schmidts 0e57127dc9 Exclude false positive from check for the documentation Makefile 2015-05-26 11:36:47 +02:00
Willi Goesgens b3e707693d polish output of check-summary 2015-05-26 11:17:58 +02:00
Willi Goesgens 81ed50551a Check whether all .md files are found in the summary.md 2015-05-26 11:15:38 +02:00
Willi Goesgens 871a95122c Work on documentation - not all documentation from the code seems to appear in the generated documentation. 2015-05-22 15:37:23 +02:00
Thomas Schmidts b1e2514163 Added new toggle and fixed the search in the docs 2015-05-21 16:05:21 +02:00
Willi Goesgens 0f42ea550e Move the index.html generator from automatic Thomas to the makefile; so linkchecker can properly run after the make cycle. 2015-05-12 14:41:14 +02:00
Jan Steemann 61e1e09be9 make documentation generation run fail when there exist output files with unreplaced @startDocuBlock markers 2015-04-03 12:45:23 +02:00
Thomas Schmidts a871127af5 Changed Makefile for gitbook 2.0.0 2015-03-27 10:01:25 +01:00
Thomas Schmidts 59311fda0f Changed design of the docs and update the themes 2015-03-03 14:25:47 +01:00