https://github.com/fliiiix/pandoc-helper

This is a small CMake helper script to create html files from markdown.
https://github.com/fliiiix/pandoc-helper

cmake cmake-scripts html markdown pandoc

Last synced: 3 days ago
JSON representation

This is a small CMake helper script to create html files from markdown.

• Host: GitHub
• URL: https://github.com/fliiiix/pandoc-helper
• Owner: fliiiix
• License: bsd-2-clause
• Created: 2019-07-21T17:30:51.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-07-21T17:33:32.000Z (over 5 years ago)
• Last Synced: 2024-12-17T16:34:05.208Z (17 days ago)
• Topics: cmake, cmake-scripts, html, markdown, pandoc
• Language: CMake
• Size: 1.95 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
CMake markdown to html converter (pandoc)

=========================================

This is a small CMake helper script to 

create html files from markdown.

## Usage

If you include the `pandoc-helper` it provides the 

`covert_md_to_html(TARGETNAME PANDOC_ARGUMENTS LIST_MD_FILES)` function.

* TARGETNAME: The name of the custom target

* PANDOC_ARGUMENTS: All additional arguments for `pandoc`

* LIST_MD_FILES: A CMake list of markdown files ending in `.md`. Relative to the current source directory.

## Example

```

include(pandoc-helper)

set(doc_resources index.md example.md)

configure_file(${CMAKE_CURRENT_SOURCE_DIR}/resources/style.css ${CMAKE_CURRENT_BINARY_DIR}/style.css COPYONLY)

covert_md_to_html(mytarget "--css=style.css --include-after-body=${CMAKE_CURRENT_SOURCE_DIR}/resources/footer.html" "${doc_resources}")

add_dependencies(doc mytarget)

```