Markdown Papers 0.1

[@dracoblue] (http://github.com/dracoblue), [@rmetzler] (http://github.com/rmetzler)

Abstract

The idea is to use a specific markdown file to write proper formatted papers and articles. It's still work in progress and only pre-alpha, but already looks quite nice.

Keywords

markdown, javascript, llncs

Example

You can use this README.md as source and generate a .html by using:

$ bin/markdown-papers README.md README.html

The output should look like that:

Pre-Conditions

You need [node.js] (http://nodejs.org), [npm] (http://npmjs.org) and the [CMU Fonts] (http://cm-unicode.sourceforge.net/) (optional, will fallback to default serif font) installed.

node.js Dependencies

• [jsdom] (https://github.com/tmpvar/jsdom)
• [markdown] (https://github.com/evilstreak/markdown-js)
• [vows] (http://vowsjs.org/) (for tests)

Use

$ ./configure

to automaticly resolve those by using [npm] (http://npmjs.org).

Installation

It's quite simple to test the current version.

Get your self a copy and configure it with npm:

$ git clone git://github.com/DracoBlue/markdown-papers.git
$ cd markdown-papers
$ ./configure

Now, test it:

$ bin/markdown-papers README.md README.html

and it will generate the README.md as a nicely formatted one.

Command line option: --template

If you want to use a different template (located at lib/templates/*.html), you must use the --template option.

$ bin/markdown-papers --template twocol README.md README.html

This will convert the .md-File by using the lib/templates/twocol.html template. You could put your own templates into that folder to make them available for the markdown-papers script.

Rules for the .md-File

Even though this is still work in progress, here are the current rules for the document.

1. Use # Title for the title of the Paper
2. Every text after the title will be used as author and aligned in center.
3. Use ### Abstract and ### Keywords to provide those sections with content.
4. Every following ## Item will be added to the table of contents and is a section.

Very simple example:

# My Paper
Mr. Author

### Abstract
This is a short one!

### Keywords
example, markdown

## Introduction
And so on

## Conclusion
Awesome 

You can also use this README.md as example.

ToDo

• clean up and document code
• add print style sheet
• generate .pdf files

Changelog

• 2012/29/01
  • added MarkdownPaper#setTemplate(template_name), which loads templates/{template_name}.html.
  • renamed screen.css to screen.default.css
  • added test for template without abstract+keywords
  • added first test for twocol-layout
  • added command line option --template

License

markdown-papers is available under the terms of MIT License.