aboutsummaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorRafael G. Martins <rafael@rafaelmartins.eng.br>2015-05-15 02:59:35 -0300
committerRafael G. Martins <rafael@rafaelmartins.eng.br>2015-05-15 02:59:35 -0300
commitf7a4ecf2add403c8b078658406fcfed5486fdd2c (patch)
treee0ea1862e0ef3bc9445dbf49d14637c279f0d968 /man
parentae6443e44a2a6e242cf97d58e608e6f21dcdc464 (diff)
downloadblogc-f7a4ecf2add403c8b078658406fcfed5486fdd2c.tar.gz
blogc-f7a4ecf2add403c8b078658406fcfed5486fdd2c.tar.bz2
blogc-f7a4ecf2add403c8b078658406fcfed5486fdd2c.zip
added initial man pages
Diffstat (limited to 'man')
-rw-r--r--man/blogc-source.7.ronn18
-rw-r--r--man/blogc-template.7.ronn18
-rw-r--r--man/blogc.1.ronn88
-rw-r--r--man/index.txt8
4 files changed, 132 insertions, 0 deletions
diff --git a/man/blogc-source.7.ronn b/man/blogc-source.7.ronn
new file mode 100644
index 0000000..71be994
--- /dev/null
+++ b/man/blogc-source.7.ronn
@@ -0,0 +1,18 @@
+blogc-source(7) -- blogc's source file format
+=============================================
+
+## SYNOPSIS
+
+TODO
+
+## DESCRIPTION
+
+TODO
+
+## AUTHOR
+
+Rafael G. Martins &lt;<rafael@rafaelmartins.eng.br>&gt;
+
+## SEE ALSO
+
+blogc(1), strptime(3)
diff --git a/man/blogc-template.7.ronn b/man/blogc-template.7.ronn
new file mode 100644
index 0000000..5883d09
--- /dev/null
+++ b/man/blogc-template.7.ronn
@@ -0,0 +1,18 @@
+blogc-template(7) -- blogc's template format
+============================================
+
+## SYNOPSIS
+
+TODO
+
+## DESCRIPTION
+
+TODO
+
+## AUTHOR
+
+Rafael G. Martins &lt;<rafael@rafaelmartins.eng.br>&gt;
+
+## SEE ALSO
+
+blogc(1)
diff --git a/man/blogc.1.ronn b/man/blogc.1.ronn
new file mode 100644
index 0000000..ddf33ca
--- /dev/null
+++ b/man/blogc.1.ronn
@@ -0,0 +1,88 @@
+blogc(1) -- a blog compiler
+===========================
+
+## SYNOPSIS
+
+`blogc` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] <SOURCE><br>
+`blogc` `-l` [`-D` <KEY>=<VALUE> ...] `-t` <TEMPLATE> [`-o` <OUTPUT>] <SOURCE> [<SOURCE> ...]<br>
+`blogc` [`-h`|`-v`]
+
+## DESCRIPTION
+
+**blogc** converts source files and templates into blog/website resources. It
+gets one (or more) source files and a template, and generates an output file,
+based on the template and the content read from the source file(s). It was
+designed to be used with make(1).
+
+`blogc` works on two modes:
+
+ * `entry`:
+ Default mode, first example in [SYNOPSIS][]. Accepts only one source
+ file, and process it as a single entry of the blog/website, like a static
+ page or a post.
+
+ * `listing`:
+ Listing mode, second example in [SYNOPSIS][], activated when
+ calling `blogc` with `-l` option. Accepts multiple source files, and allow
+ users to iterate over the content of all the source files to produce listing
+ pages, like indexes and feeds.
+
+## OPTIONS
+
+ * `-l`:
+ Activates listing mode, allowing user to provide multiple source files. See
+ blogc-source(7) for details.
+
+ * `-D` <KEY>=<VALUE>:
+ Set global configuration parameter. <KEY> must be an ascii uppercase string,
+ with only letters, numbers (after the first letter) and underscores (after
+ the first letter). These parameters are available anywhere in templates,
+ but may be overridden by local configuration parameters set in source files.
+ See blogc-template(7) for details.
+
+ * `-t` <TEMPLATE>:
+ Template file. It is a required option. See blogc-template(7) for details.
+
+ * `-o` <OUTPUT>:
+ Output file. If provided this option, save the compiled output to the given
+ file. Otherwise, the compiled output is sent to `stdout`.
+
+ * `-v`:
+ Show program name, version and exit.
+
+ * `-h`:
+ Show help message and exit.
+
+## FILES
+
+The `blogc` command expects a template file blogc-template(7), one (or more)
+source files blogc-source(7) and an output file, if wanted.
+
+## ENVIRONMENT
+
+No environment variables are required by `blogc`, but global timezone will
+be used by locale-dependant datetime input field descriptors (like `%c`, and
+can be overridden using environment variables. See strptime(3).
+
+## EXAMPLES
+
+Build index from source files:
+
+ $ blogc -l -t template.tmpl -o index.html source1.txt source2.txt source3.txt
+
+Build entry page from source file:
+
+ $ blogc -t template.tmpl -o entry.html entry.txt
+
+## BUGS
+
+**blogc** is based in handwritten parsers, that even being well tested, may be
+subject of parsing bugs.
+
+## AUTHOR
+
+Rafael G. Martins &lt;<rafael@rafaelmartins.eng.br>&gt;
+
+## SEE ALSO
+
+blogc-source(7), blogc-template(7), make(1), strptime(3)
diff --git a/man/index.txt b/man/index.txt
new file mode 100644
index 0000000..4ff99f5
--- /dev/null
+++ b/man/index.txt
@@ -0,0 +1,8 @@
+# manuals
+blogc(1) blogc.1.ronn
+blogc-source(7) blogc-source.7.ronn
+blogc-template(7) blogc-template.7.ronn
+
+# external manuals
+make(1) http://man.cx/make(1)
+strptime(3) http://man.cx/strptime(3)