Support for using mrdocs to generate docs from code

Author: steve-downey

.gitignore

@@ -31,3 +31,4 @@ compile_commands.json
 
 /docs/html
 /docs/latex
+/docs/adoc/

Makefile

@@ -57,8 +57,16 @@ $(_build_path)/CMakeCache.txt: | $(_build_path) .gitmodules
 	-rm compile_commands.json
 	ln -s $(_build_path)/compile_commands.json
 
+$(_build_path)/compile_commands.json : $(_build_path)/CMakeCache.txt
+
+compile_commands.json: $(_build_path)/compile_commands.json
+	-rm compile_commands.json
+	ln -s $(_build_path)/compile_commands.json
+
 TARGET:=all
+compile: compile_commands.json
 compile: $(_build_path)/CMakeCache.txt ## Compile the project
+compile:  ## Compile the project
 	cmake --build $(_build_path)  --config $(CONFIG) --target all -- -k 0
 
 compile-headers: $(_build_path)/CMakeCache.txt ## Compile the headers
@@ -178,6 +186,12 @@ view-coverage: ## View the coverage report
 docs: ## Build the docs with Doxygen
 	doxygen docs/Doxyfile
 
+.PHONY: mrdocs
+mrdocs: ## Build the docs with Doxygen
+	-rm -rf docs/adoc
+	cd docs && NO_COLOR=1 mrdocs mrdocs.yml 2>&1 | sed 's/\x1b\[[0-9;]*m//g'
+	find docs/adoc -name '*.adoc' | xargs asciidoctor
+
 # Help target
 .PHONY: help
 help: ## Show this help.

docs/mrdocs.yml

@@ -1,3 +1,6 @@
+# $schema: https://mrdocs.com/docs/mrdocs/develop/_attachments/mrdocs.schema.json
+# yaml-language-server: $schema=https://mrdocs.com/docs/mrdocs/develop/_attachments/mrdocs.schema.json
+
 ---
 source-root: ..
 input:
@@ -6,6 +9,8 @@ exclude:
   - ../include/beman/optional/detail
 exclude-patterns:
   - ../include/beman/optional/detail/**
+  - ../tests/**
+  - ../examples/**
 includes:
   - ../include
 file-patterns:
@@ -16,3 +21,4 @@ implementation-defined:
   - 'beman::optional::detail'
 multipage: true
 generator: adoc
+output: adoc