A blog system based on plain-files.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

66 lines
2.1 KiB

7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
7 months ago
  1. # Python Flask Blog
  2. This is a simple blog based on Pythons Flask framework.
  3. The basic design is based on LukeSmithXYZs blog.
  4. However I dislike using a script for adding entries and just want to add entries via plain text files.
  5. ## Features/To-Dos
  6. - [x] Plain text support for blog entries
  7. - [x] HTML files (.html)
  8. - [x] Markdown Files (.md)
  9. - [x] Infinite-scroll blog page
  10. - [x] Archive page
  11. - [x] Months as headings
  12. - [x] Links to scrolling blog page
  13. - [ ] Links to standalone article
  14. - [ ] Standalone article page
  15. - [x] RSS feed
  16. - [ ] Better navigation
  17. - [ ] Header
  18. - [ ] Footer
  19. - [ ] Switchable CSS
  20. - [ ] CSS dark-theme
  21. - [ ] CSS light-theme
  22. - [x] Docker installation
  23. ## Usage
  24. ### Create entries
  25. Blog entries are managed by plain html files in the `templates/entry/` directory.
  26. The first line of each document is reserved as the title of the document.
  27. You have to specify the filetype by extension.
  28. ## Deployment
  29. ### PIP/Python
  30. - `git clone https://github.com/tiyn/tiyny-blog`
  31. - `cd flaskblog/src`
  32. - `pip3install -r requirements.txt` - install depenencies
  33. - run `python app.py`
  34. - blog is available on port 5000
  35. ### Docker
  36. #### Volumes
  37. Set the following volumes with the -v tag.
  38. | Volume-Name | Container mount | Description |
  39. |-------------|----------------------|-----------------------------------------------------------------------|
  40. | css | /blog/src/static/css | Directory for css files |
  41. | html | /blog/src/templates | Directory for templates and html documents (contains entry directory) |
  42. #### Ports
  43. Set the following ports with the -p tag.
  44. | Container-Port | Recommended outside port | Protocol | Description |
  45. |----------------|--------------------------|----------|-------------|
  46. | 5000 | 80 | TCP | HTTP port |
  47. #### Example run-command
  48. `docker run --name blog --restart unless-stopped -v css:/blog/src/static/css -v html:/blog/src/templates -p 80:5000 -d tiynger/tiyny-blog`