https://github.com/avelino/liquidluck

Felix Felicis (aka liquidluck) is a static blog generator in python
https://github.com/avelino/liquidluck

Last synced: 11 days ago
JSON representation

Felix Felicis (aka liquidluck) is a static blog generator in python

• Host: GitHub
• URL: https://github.com/avelino/liquidluck
• Owner: avelino
• Archived: true
• Created: 2011-09-03T13:31:48.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2021-06-04T07:49:04.000Z (over 3 years ago)
• Last Synced: 2024-08-02T14:12:15.189Z (4 months ago)
• Language: Python
• Homepage:
• Size: 989 KB
• Stars: 334
• Watchers: 19
• Forks: 52
• Open Issues: 12
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
Felix Felicis

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

.. image:: https://travis-ci.org/lepture/liquidluck.png?branch=master

    :target: https://travis-ci.org/lepture/liquidluck

Felix Felicis (aka ``liquidluck``) is a simple lightweight static blog generator

written in Python.

**There are so many static blog generators, why create a new one?**

The main design pattern of Felix Felicis:

1. Beautiful is better than ugly.

2. Nothing is better than everything.

`Documentation `_ is available on RTD.

Commands

------------

1. Create a site::

    liquidluck init

2. Search for a theme::

    liquidluck search

3. Install a theme::

    liquidluck install moment

4. Build articles::

    liquidluck build

5. Preview server::

    liquidluck server

More information with ``liquidluck help``.

Write a post

----------------------

A post in markdown::

    # Hello World

    - date: 2012-06-11

    - tags: python, javascript

    -------

    Hello World in Python

    ```python

    def hello(name="World"):

        print "Hello %s" % name

    ```

    Hello World in JavaScript

    ```javascript

    function hello(name) {

        alert('Hello ' + name);

    }

    ```

A post in restructuredText::

    Hello World

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

    :date: 2012-06-11

    :tags: python, javascript

    Hello World in Python::

        def hello(name="World"):

            print "Hello %s" % name

    Hello World in JavaScript:

    .. sourcecode:: javascript

        function hello(name) {

            alert('Hello ' + name);

        }

Both of these two posts are valid in their markup language, even without Felix Felicis

they should be displayed well.

And in this case, your documents will always be yours, not tied to Felix Felicis.

Features

-----------

- Category, Tag, Post, Page, Feed and everything a blog should have

- Beautiful and valid syntax supports

- Full customizable theme supports

- Global theme gallery, site theme gallery, site template

- No extension system (Is this a feature? YES!)

- GitHub and BitBucket web hook service

- Live preview server

Compatibility

--------------

+ Markup:

  - restructedText_

  - markdown_

+ Python:

  - 2.6

  - 2.7

  - 3.3

  - 3.4

  - 3.5

.. _restructedText: http://docutils.sourceforge.net/rst.html

.. _markdown: http://daringfireball.net/projects/markdown/