CMake code to support asciidoc

nospam@example.com (Graham Cox) — Fri, 07 Nov 2008 13:14:38 +0000

Asciidoc is a really useful and sensible way of allowing people to write documentation, in that the plain text source code is nearly as readable as the generated output. The following is a CMake file to allow for conversion of text input files into asciidoc generated output files



PROJECT(Document)

FIND_PACKAGE(Asciidoc)

IF(ASCIIDOC_FOUND)

  FILE(GLOB _docfiles *.txt)



  FOREACH(_file ${_docfiles})

    GET_FILENAME_COMPONENT(_file_we ${_file} NAME_WE)

    SET(_in "${_file_we}")

    SET(_out "${_file_we}.html")

    IF (NOT "${_in}" STREQUAL "CMakeLists")

        ADD_CUSTOM_COMMAND(

            OUTPUT    "${_out}"

            COMMAND   ${ASCIIDOC_EXECUTABLE} -a toc -o ${_out} ${_file}

            DEPENDS   ${_file}

            COMMENT   "Asciidoc ${_in}"

        )

        ADD_CUSTOM_TARGET(${_in} ALL echo

          DEPENDS   "${_out}"

        )

    ENDIF (NOT "${_in}" STREQUAL "CMakeLists")



  ENDFOREACH(_file)

ENDIF(ASCIIDOC_FOUND)

And it needs the following FindAsciidoc.cmake file available



# - Find Asciidoc

# this module looks for asciidoc

#

#  ASCIIDOC_EXECUTABLE - the full path to asciidoc

#  ASCIIDOC_FOUND      - If false, don't attempt to use asciidoc.



FIND_PROGRAM(ASCIIDOC_EXECUTABLE

  asciidoc

  )



MARK_AS_ADVANCED(

  ASCIIDOC_EXECUTABLE

  )



IF (NOT ASCIIDOC_EXECUTABLE)

  SET(ASCIIDOC_FOUND "NO")

ELSE (NOT ASCIIDOC_EXECUTABLE)

  SET(ASCIIDOC_FOUND "YES")

ENDIF (NOT ASCIIDOC_EXECUTABLE)





IF (NOT ASCIIDOC_FOUND AND Asciidoc_FIND_REQUIRED)

   MESSAGE(FATAL_ERROR "Could not find asciidoc")

ENDIF (NOT ASCIIDOC_FOUND AND Asciidoc_FIND_REQUIRED)

This site works best in a real browser - CMake

CMake code to support asciidoc