Blio - domms blogging "engine"
version 2.007
Backend for the blio.pl command. See blio.pl and/or perldoc blio.pl for details.
blio.pl
perldoc blio.pl
more docs pending...
docs provided by gabor, need to be integrated:
The configuration parameters can be provided either in the configuration file that defauts to blio.ini or on the command line.
The configuration file can look like this:
name=Test site source_dir=src/ output_dir=. template_dir=templates/
The configureation file must exists. Otherwise you will get a warning like this:
Specified configfile 'blio.ini' does not exist, is empty, or is not readable
If no source_dir provided or there is no src/ directory, you get this exception:
Can't call method "done" on an undefined value at .../Blio.pm line 137.
The name of the site in the title of the pages. Default to Blio
The directory where the source files are. Each page of the site has a corresponding source file with .txt extension. Defaults to the src/ directory relative to the current working directory where your run the build.pl script.
src/
build.pl
Directory where the generated html files should go. Defaults to out/ relative to the current working directory.
out/
The location of the template files. Defaults to templates/ relative to the current working directory. As a fallback, there is a set of templates provided by Blio. They come in the share/templates directory of the distribution and are installed along the module.
templates/
TODO - there are more fields that need explanation.
The source directory defined using the source_dir paramater can havs subdirectories, but each subdirectory needs a 'parent' page. The name of the parent page is the same as the name of the subdirectory with the additional .txt extentsion. So if you'd like to have a src/project/ subdriectory, you also need to have a page called src/project.txt.
source_dir
src/project/
src/project.txt
If there is no index.txt in the src/ directory, Blio will generate a default index.html file. This is not the case with subdirectories.
Each source file has a txt extension. It has several lines of header and a body. The module that represents each file is Blio::Node.
title: The Project date: 2013-02-10T00:27:53 language: en converter: textile tags: Perl This is the project page.
The only required entry in the header is the title.
title
Thomas Klausner <domm@plix.at>
This software is copyright (c) 2013 - 2022 by Thomas Klausner.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Blio, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Blio
CPAN shell
perl -MCPAN -e shell install Blio
For more information on module installation, please visit the detailed CPAN module installation guide.