From 949e73c52250a9b26e655d8a6c3ccc138dfb00cc Mon Sep 17 00:00:00 2001 From: Patryk NiedΕΊwiedziΕ„ski Date: Mon, 14 Oct 2019 00:13:47 +0200 Subject: Add documentation --- docs/README.md | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) (limited to 'docs') diff --git a/docs/README.md b/docs/README.md index 616fbb7..8109cca 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,19 +1,35 @@ # Kronikarz -Required folder structure: +Kronikarz is a file based system for managing blog posts. It's original purpose was to have an universal way for creating chronicles of scouting troops. But it's not only for scouts πŸ˜‰. +## Getting started + +Kronikarz has it's own rule for managing posts and at this point it is hard-coded. Required folder structure looks like this: + +``` +your_folder +└── {year} + └── {month} + └── {title} + └── {title}.md ``` -year -└── month - └── title - └── title.md + +Firstly install kronikarz with npm + +```bash +npm install kronikarz ``` -To parse all posts run: +To use kronikarz you need to initialize it first with path to folder where all your posts are. If look at the example above it would be path to `your_folder`. You need to remember that when you run a script with npm current working directory is always root directory. ```js import Kronikarz from "kronikarz"; const k = new Kronikarz("path/to/posts"); +``` + +At this point only one method is available. + +```js k.getPosts(); ``` -- cgit 1.4.1