JSPM

docpad-plugin-orgmode

2.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 8
  • Score
    100M100P100Q16493F

DocPad plugin that adds the ability to render org-mode (the Emacs-mode) to HTML

Package Exports

  • docpad-plugin-orgmode

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (docpad-plugin-orgmode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

OrgMode Plugin for DocPad

NPM version

Convert documents written in org-mode to HTML

Convention: .html.org

Uses org-js to do the actual conversion

Install

docpad install orgmode

Using

Just create a document with the ending .html.org and start editing (Remark: for editing you will probably want to use GNU Emacs or one of its derivatives as org-mode-files are not much fun to edit without that mode).

A file would look like this:

---
title: "Test with org-mode"
layout: "default"
---
* First Section
  Some text
* *Important* section
  More text

If in the main section a #+TITLE: is set it overrides the title in the header.

Options can either be passed in the header in an orgmode-section like this:

---
title: "Test-file"
orgmode:
  showTitle: false
---

Or in the docpad.coffee-file as global presets:

docpadConfig = {
plugins:
  orgmode:
    headerOffset: 1
}

Available options are:

  • showToc: Show the table of contents created by the parser. Default: true
  • showTitle: Show the title as a <h1> header. Default: true
  • headerOffset: Parameter from org-js. Increment the header levels by this. Default: 1
  • exportFromLineNumber: Parameter from org-js
  • suppressSubScriptHandling: Parameter from org-js
  • suppressAutoLink: Parameter from org-js

History

You can discover the history inside the History.md file

License

Licensed under the incredibly permissive MIT License

Copyright © 2014+ Bernhard F.W. Gschaider