Metadata-Version: 2.0
Name: wt
Version: 0.5.1
Summary: Static blog generator
Home-page: https://github.com/ysegorov/wt
Author: Yuri Egorov
Author-email: ysegorov@gmail.com
License: MIT
Keywords: blog static site generator
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: cached-property (>=1.3.0)
Requires-Dist: jinja2 (>=2.8)
Requires-Dist: markdown (>=2.6.6)
Requires-Dist: pyyaml (>=3.12)
Provides-Extra: dev
Requires-Dist: coverage (>=4.2); extra == 'dev'
Requires-Dist: pytest (>=3.0.0); extra == 'dev'
Requires-Dist: pytest-catchlog (>=1.2.2); extra == 'dev'
Requires-Dist: pytest-cov (>=2.3.1); extra == 'dev'
Requires-Dist: pytest-describe (>=0.11.0); extra == 'dev'
Requires-Dist: twine (>=1.8.1); extra == 'dev'

# wt - static blog generator

![Logo](misc/logo96.png)

[![Build Status](https://travis-ci.org/ysegorov/wt.svg?branch=master)](https://travis-ci.org/ysegorov/wt)


## What

Pretty small and simplified static blog generator with following features:

- [markdown][markdown] for content
- [yaml][yaml] for configuration
- [jinja2][jinja2] for templating
- [atom][atom] for feed
- python's standard library `HTTPServer` as a development http server
- only two types of content - **page** and **post**
- content metadata lives in configuration file, configuration file can be
  splitted into multiple nested files
- have sensible defaults for content sources
- no python coding needed to work with


## Why

While [pelican][pelican] is great and is full of features and [grow][grow] is
another one and looks very interesting in this field and there are a lot more
static site generators I wanted to create something easy to work with.

Hope someday somebody will find this library pretty usefull.


## How

### Requirements

The only hard dependency is **python3**.

### Installation

```shell
$ mkdir blog && cd blog
$ mkdir env && virtualenv -p python3 env && source ./env/bin/activate
$ pip install wt

```

### Bootstrapping

```shell
$ wt init .

```

### Configuration

Your blog must have configuration file written in [yaml][yaml] and named
**wt.yaml** (name can be changed).

### Usage

While writing content (ie in development mode):

```shell
$ wt develop

```

This command will start the development server listening at 127.0.0.1:9000.

When content is ready you will need to build it:

```shell
$ wt build

```


## Roadmap

- [x] ~~documentation~~
- [x] ~~posts list pagination~~
- [ ] support for tags


## License

MIT


[markdown]: http://daringfireball.net/projects/markdown/
[yaml]: http://yaml.org/
[jinja2]: http://jinja.pocoo.org/
[atom]: https://en.wikipedia.org/wiki/Atom_(standard)
[pelican]: http://docs.getpelican.com/
[grow]: https://grow.io/


