diff options
| -rw-r--r-- | doc/CMakeLists.txt | 7 | ||||
| -rw-r--r-- | doc/Doxyfile.in | 2 | ||||
| -rw-r--r-- | doc/apidoc.css | 3 | ||||
| -rw-r--r-- | flake.nix | 1 |
4 files changed, 11 insertions, 2 deletions
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt index 1459bac7..9f5745ea 100644 --- a/doc/CMakeLists.txt +++ b/doc/CMakeLists.txt @@ -9,6 +9,9 @@ cmake_minimum_required(VERSION 3.16.2) project(ledger NONE) +set(DOXYGEN_EXTRA_CSS CACHE STRING + "Path to extra css file added to the generated API documentation") + # Point CMake at any custom modules we may ship list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}") include(LedgerVersion) @@ -28,11 +31,13 @@ if (USE_DOXYGEN) # see INPUT/FILE_PATTERNS in Doxyfile.in file(GLOB doxygen_input_files ${CMAKE_CURRENT_SOURCE_DIR}/../src/*.h) - add_custom_command(OUTPUT html/index.html + add_custom_command(OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/html/index.html COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile ${doxygen_input_files} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} COMMENT "Building doxygen documentation") + install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html + DESTINATION ${CMAKE_INSTALL_DOCDIR} COMPONENT doc) add_custom_target(doc.doxygen DEPENDS html/index.html) else() add_custom_target(doc.doxygen) diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in index 58683baa..a2691e4e 100644 --- a/doc/Doxyfile.in +++ b/doc/Doxyfile.in @@ -942,7 +942,7 @@ HTML_STYLESHEET = # robust against future updates. Doxygen will copy the style sheet file to # the output directory. -HTML_EXTRA_STYLESHEET = +HTML_EXTRA_STYLESHEET = @CMAKE_CURRENT_SOURCE_DIR@/apidoc.css @DOXYGEN_EXTRA_CSS@ # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or # other source files which should be copied to the HTML output directory. Note diff --git a/doc/apidoc.css b/doc/apidoc.css new file mode 100644 index 00000000..b180c415 --- /dev/null +++ b/doc/apidoc.css @@ -0,0 +1,3 @@ +/* Use this file to customize styling Ledger API Documentation of generated with doxygen */ + +img.footer { width: 50px } @@ -2,6 +2,7 @@ description = "A double-entry accounting system with a command-line reporting interface"; nixConfig.bash-prompt = "ledger$ "; + outputs = { self, nixpkgs }: let usePython = true; gpgmeSupport = true; |