Total Pageviews

Saturday, 24 August 2019

一个基于flask的博客程序-WeBlog


A simple blog system based on Flask

Quick Start

$ git clone https://github.com/ghostrong/weblog.git
$ cd weblog
$ pip install -r requirements.txt
$ python run.py
Now, visit http://127.0.0.1:8888 in a browser.

Requirements

For the server-side

  • Flask
  • Flask-SQLAlchemy
  • itsdangerous
  • Jinja2
  • Markdown
  • MarkupSafe
  • SQLAlchemy
  • Werkzeug

For the cline-side (for publishing articles automatically)

  • requests
  • lxml
  • PyYAML
  • Markdown

Writing blogs

You should write articles in markdown, and provide the meta information such as title, tags in YAML. You should put the meta data in the header lines of the markdown file. Here is an example.

Meta Data

  • title
    You must give the title the the blog. e.g.,
    title: The Zen of Python
    
  • summary (optional)
    It's the abstract of the article. If you ignore it, the publish helper will generate the summary snippet from the body automatically. e.g.,
    summary:
      Long time Pythoneer Tim Peters succinctly channels the BDFL's
      guiding principles for Python's design into 20 aphorisms, only 19
      of which have been written down.
    
  • pub_time (optional)
    You can define the publish datetime manually. Or, the system will assign the current datetime. The default format is "%Y-%m-%d %H:%M:%S" (such as "2015-06-06 12:40:10"). You could define the time string format by the value of TIME_FORMAT in config.py, and you should conform to the format codes. e.g.,
    pub_time: 2015-06-06 12:40:10
    
  • tags (optional)
    It's useful to assign tags to an article. The value type should be list in YAML. e.g.,
    tags:
      - python
      - programming
    

The boundry of meta

The meta data should be located between '---' and '...'. The following is an example of meta infomration:
---
title: The Zen of Python
summary:
  Long time Pythoneer Tim Peters succinctly channels the BDFL's
  guiding principles for Python's design into 20 aphorisms, only 19
  of which have been written down.
tags:
  - python
  - programming
...

You should write the body content from here...

Publishing blogs

We provide a simple script to make the publishing work easy. Run publish.py to check the help message.
$ python publish

usage: publish.py [-h] [-p PATH] [-a API] [-t TOKEN]

optional arguments:
  -h, --help            show this help message and exit
  -p PATH, --path PATH  markdown file path/url
  -a API, --api API     api address
  -t TOKEN, --token TOKEN
                        access token
You should provide the markdown file(either file-path or raw-url), the target api, and the access token. In this blog system, the publish url is /publish. The access token is the value of TOKEN in config.pyAnyone who know the token could publish articles to your blog system, so keep it secret!!
After starting the web server locally, you can publish an article like this:
$ python publish.py -a http://127.0.0.1:8888/publish -p example.md

Features

  • Writing blogs in Markdown and YAML
  • Browsing blogs by PAGE or TAG
  • Neat templates :-)
  • Search (TBD)

No comments:

Post a Comment