Skip to content

Templates and Makefiles to build publication in multiple formats based on a source file in Pandoc Markdown

Notifications You must be signed in to change notification settings

jakobib/makedoc

Repository files navigation

makedoc

makedoc ist a git repository containing Makefiles and templates to create papers and presentations from source files in Pandoc Markdown. The current version can be found at https://github.com/jakobib/makedoc. Feel free to comment, reuse, fork, and modify!

makedoc is accompanied by makespec, a similar tool to create specifications (makedoc and makespec may later be merged).

Usage

First steps

  1. Create a directory for your publication (possibly as git repository).

    mkdir example
    cd example
    git init
    
  2. Check out this module in a subdirectory called 'make' (possibly as git submodule):

    git submodule add https://github.com/jakobib/makedoc.git
    
  3. Create a Makefile that at least contains include makedoc/Makefile.

  4. Optionally create the file metadata.ini with title, abstract, keywords. This will be passed to templates.

Commands

make foo.html creates HTML from a markdown file foo.md. Use make -B foo.html to force creation.

make normalize normalizes all .md files in the current directory. A backup is created with file extension .md.bak.

make clean removes all backup files and build artifacts.

About

Templates and Makefiles to build publication in multiple formats based on a source file in Pandoc Markdown

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published