This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A creole markup converter for Holocron

Project Description

Creole is a lightweight markup language, aimed at being a common markup language for wikis, enabling and simplifying the transfer of content between different wiki engines.

holocron-creole is a Creole markup converter for Holocron, an extendable static blog generator powered by the Force

Installation

Holocron uses entry-points based extension discovery mechanism, and that means it’s enough to use pip to install creole converter:

$ [sudo] pip install holocron-creole

Usage

Usage experience is similar to Markdown or reStructuredText builtin converters.

  1. Ensure that creole extension is enabled in your _config.yml:

    ext:
      enabled:
         - markdown
         - restructuredtext
         - creole                # inserted line
         - index
         - feed
         - sitemap
         - tags
    
  2. Create posts and/or pages with .creole extension. Similar to builtin converters, a meta information header could be places on the top of *.creole files.

    ---
    tags: [jedi, thoughts, any-custom-tag]
    ---
    
    = Jedis in Real World =
    
    Jedi is ...
    
  3. Creole converter supports code syntax highlighting feature. It could be turned on/off by editing the following option:

    ext:
       creole:
          syntax_highlight: true
    

    When it’s turned on, the <<code>> macros is available for using. Example:

    <<code ext=".py">>
        def add(x, y):
            return x + y
    <</code>>
    

Why GPL?

Despite the fact Holocron is distributed under BSD license, holocron-creole is licensed under GPLv3. The reason is that the project depends on python-creole library, and it’s distributed under GPLv3. That means we have no choice but to use GPL.

Release History

Release History

This version
History Node

1.0.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
holocron-creole-1.0.0.tar.gz (19.2 kB) Copy SHA256 Checksum SHA256 Source Oct 27, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting