inching slowly towards a renderer

share/CMakeLists.txt

@@ -0,0 +1,20 @@
+find_package(mkdocs 1.0)
+
+# if(MKDOCS_FOUND)
+# 	configure_file(mkdocs.yml "${CMAKE_CURRENT_BINARY_DIR}/mkdocs.yml" COPYONLY)
+# 	set(MKDOCS_FLAGS
+# 		--site-dir "${CMAKE_CURRENT_BINARY_DIR}/docs/user/"
+# 		--config-file "${CMAKE_CURRENT_BINARY_DIR}/mkdocs.yml"
+# 		)
+# 	if(DEBUG_MODE)
+# 		list(APPEND MKDOCS_FLAGS --clean --verbose)
+# 	endif()
+# 	add_custom_target(docs-user
+# 		${MKDOCS_EXECUTABLE} build ${MKDOCS_FLAGS}
+# 		WORKING_DIRECTORY "${CMAKE_SOURCE_DIR}"
+# 		COMMENT "Generating user documentation"
+# 		)
+# 	add_dependencies(docs docs-user)
+# else()
+# 	message(STATUS "SKIPPING generation of user documentation (mkdocs not found)")
+# endif()

share/docs/index.md

@@ -0,0 +1,17 @@
+# Welcome to MkDocs
+
+For full documentation visit [mkdocs.org](https://mkdocs.org).
+
+## Commands
+
+* `mkdocs new [dir-name]` - Create a new project.
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs help` - Print this help message.
+
+## Project layout
+
+    mkdocs.yml    # The configuration file.
+    docs/
+        index.md  # The documentation homepage.
+        ...       # Other markdown pages, images and other files.

share/mkdocs.yml

@@ -0,0 +1 @@
+site_name: pixwerx engine