From a0dccc770d57046aee398df70c6878cbf3a16eaa Mon Sep 17 00:00:00 2001 From: Tissevert Date: Mon, 26 Oct 2020 21:32:29 +0100 Subject: [PATCH] Fill-in description for the --pages command line option --- doc/Command-line.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/doc/Command-line.md b/doc/Command-line.md index 26cb826..1daf3eb 100644 --- a/doc/Command-line.md +++ b/doc/Command-line.md @@ -32,6 +32,8 @@ hablo --articles turtles /path/to/your/blog See ? It was still `turtles` and not ~~`/path/to/your/blog/turtles`~~. +Also note that articles are partly optional : you can use hablo to generate a website with a fix content and no articles. In that case, just make sure no directory named `articles/` exists at the root of your website (see [pages](#pages-path)) and keep in mind that it should have static pages (hablo, just like other famous entities should not be invoked in vain and will exit in error suspecting something went wrong when invoked on an empty website with no articles and no pages, which to it means nothing to do). + ## Banner `-b, --banner` @@ -116,11 +118,25 @@ hablo --name "Turtles/Paradize" Enables Open Graph cards in pages to display a pretty preview of them instead of the raw URL in links posted to social media. Note that this feature requires setting your site URL with [`--site-url`](#site-url). -## Pages +## Pages path `-p, --pages` -This option doesn't work yet but hablo will support static pages in addition to articles in a future release. Like [articles](#article-path), they will be expected to be located in a sub-directory called `pages/` but this option will allow you to use an arbitrary path within your blog's structure. +In addition to «dynamic» lists of articles that grow over time, hablo supports «static» pages to allow you to publish relatively constant information related to your blog. Pages are expected to be located in a sub-directory called `pages/` but this option will allow you to use an arbitrary path within your blog's structure. + +So if for instance your blog is for a community of authors and a presentation of each of them is all you want to publish as «static» content, you could have this directory called «authors» and run `hablo` like this : + +```bash +hablo --pages authors +``` + +This option is very similar to the one for [articles](#articles-path). Like the articles path, the pages path is of course relative to the blog's root. Pages are also partly optional : you don't have to have static pages in your blog in which case you should just make sure no directory named `pages/` exists at the root of your website and you have articles (because like we said above hablo is highly suspicious of being invoked to perform no work and will suspect this is a mistake and report it as an error). + +Final tip : if you're using hablo to edit a static website with no articles, then you probably don't want to put your pages in a sub-directory but have them at the root of your website instead. This is possible, just remember that the current directory is called `.` in UNIX and run : + +```bash +hablo -p . +``` ## Number of articles previewed