New blog entry (public blog engine)
This commit is contained in:
Yann Esposito (Yogsototh)
parent
3e0259c4a2
commit
883e36336a
4 changed files with 431 additions and 1 deletions
138
content/html/en/blog/2010-06-15-Get-my-blog-engine.md
Normal file
138
content/html/en/blog/2010-06-15-Get-my-blog-engine.md
Normal file
|
|
@ -0,0 +1,138 @@
|
|||
-----
|
||||
isHidden: false
|
||||
menupriority: 1
|
||||
kind: article
|
||||
created_at: 2010-06-15T10:56:32+02:00
|
||||
title: Get my blog engine
|
||||
author_name: Yann Esposito
|
||||
author_uri: yannesposito.com
|
||||
tags:
|
||||
- blog
|
||||
- nanoc
|
||||
-----
|
||||
|
||||
I published a *light* version of my blog engine based on [nanoc](http://nanoc.stoneship.org) yesterday night. By *light*, I mean a lighter, more portable CSS (without round border).
|
||||
You can get it on [github.com](http://github.com/yogsototh/nanoc3_blog).
|
||||
|
||||
What this system provide?
|
||||
|
||||
|
||||
* All [nanoc](http://nanoc.stoneship.org) advantages,
|
||||
* Easy multi-language handling,
|
||||
* Syntax Coloration for most languages,
|
||||
* [intenseDebate](http://intensedebate.org) comments integration (asynchronous) ;
|
||||
* Portable with and without javascript, XHTML Strict 1.0 / CSS3,
|
||||
* Write in markdown format (no HTML editing needed),
|
||||
* Typographic ameliorations (no ':' starting a line in French for example),
|
||||
* [Graphviz](http://graphviz.org) graph generation integration.
|
||||
|
||||
|
||||
newcorps
|
||||
|
||||
# Main Documentation Page
|
||||
|
||||
|
||||
# Use It NOW!
|
||||
|
||||
Once installed (follow the README.md instructions).
|
||||
|
||||
<code class="zsh">
|
||||
$ cd /root/of/nanoc3_blog
|
||||
$ ./task/new_blog_entry Title of the blog
|
||||
$ vi latest.md
|
||||
$ ./task/recompile
|
||||
</code>
|
||||
|
||||
Now your website reside into the `output` directory.
|
||||
|
||||
newcorps
|
||||
|
||||
# Documentation
|
||||
|
||||
## Useful things to know
|
||||
|
||||
### Multi-language
|
||||
|
||||
All files in `multi` are processed and copied in the `content` directory.
|
||||
For each file in multi, each line starting by '`fr: `' are copied (without the `fr: ` into the `content/html/fr/` tree, but not into the `content/html/en` tree. File not starting by `fr: ` or `en: ` are copied in each destinations.
|
||||
|
||||
If you want to add another language, you'll have to modify `tasks/config`, and `config.yaml`, create a `content/html/xx` where `xx` is the language code.
|
||||
|
||||
### Edition & Rendering
|
||||
|
||||
#### additional keywords
|
||||
|
||||
You can separate multi content div using the: `n``ewcorps` directive (see examples).
|
||||
|
||||
You can create div using `b``egindiv(classname)`, `e``nddiv`. (See some existing blog entries for example). Use the class `intro` for the abstract part.
|
||||
|
||||
You can create nice description table using `<``desc>` (See source code for example).
|
||||
|
||||
#### Typography
|
||||
|
||||
In French all ':', ';', '!' and '?' are preceded automatically by ` `. This enable not to have a line starting by a single special character.
|
||||
|
||||
You can use small caps using `<sc>` tags.
|
||||
|
||||
* `(c``)` is replaced by (c).
|
||||
* `(r``)` is replaced by (r).
|
||||
* `<``-` is replaced by <-.
|
||||
* `-``>` is replaced by ->.
|
||||
|
||||
#### source code
|
||||
|
||||
To write source code you should use the following format:
|
||||
|
||||
<code class="html">
|
||||
<code class="ruby" file="filename.rb">
|
||||
The code
|
||||
</cOde>
|
||||
</code>
|
||||
|
||||
The `file` attribute is not required.
|
||||
|
||||
|
||||
### blog
|
||||
|
||||
If you want to make really long blog post, you can separate them into many files. To accomplish that, you simply have to make your files like:
|
||||
|
||||
<pre class="twilight">
|
||||
multi/blog/2010-06-01-the-title.md
|
||||
multi/blog/2010-06-01-the-title/second_part.md
|
||||
multi/blog/2010-06-01-the-title/third_part.md
|
||||
</pre>
|
||||
|
||||
|
||||
### mobileme
|
||||
|
||||
All files are intended to be generated into the `output/Scratch` directory.
|
||||
This was made like that to work nicely with iWeb organisation of websites.
|
||||
|
||||
### menu
|
||||
|
||||
The order of post is done using the `menupriority` meta-data in the header of the files.
|
||||
|
||||
You can hide some file from the menu by setting: `isHidden: true` in the header.
|
||||
|
||||
|
||||
## Details
|
||||
|
||||
To know more about this blog engine, you should look at
|
||||
[nanoc](http://nanoc.stoneship.org) project.
|
||||
|
||||
Then look at the files inside your project:
|
||||
|
||||
<desc>
|
||||
README.md : readme for the project (used by github) ::
|
||||
latest.md : symbolic link to the last blog entry ::
|
||||
multi/ : Directory containing multi-language articles ::
|
||||
tasks/ : scripts for website live ::
|
||||
config.yaml : global configuration file ::
|
||||
Rules : generation rules ::
|
||||
content/ : content files processed by nanoc ::
|
||||
layouts/ : erb templates ::
|
||||
lib/ : ruby libraries used to process files ::
|
||||
output/ : website ::
|
||||
Rakefile : not mandatory for this blog ::
|
||||
tmp
|
||||
</desc>
|
||||
140
content/html/fr/blog/2010-06-15-Get-my-blog-engine.md
Normal file
140
content/html/fr/blog/2010-06-15-Get-my-blog-engine.md
Normal file
|
|
@ -0,0 +1,140 @@
|
|||
-----
|
||||
isHidden: false
|
||||
menupriority: 1
|
||||
kind: article
|
||||
created_at: 2010-06-15T10:56:32+02:00
|
||||
title: Récupérez mon système de blog
|
||||
author_name: Yann Esposito
|
||||
author_uri: yannesposito.com
|
||||
tags:
|
||||
- blog
|
||||
- nanoc
|
||||
-----
|
||||
|
||||
J'ai publié une version *light* de mon système de blog hier soir. Par *light* il faut comprendre avec un CSS plus épuré et plus portable (sans les bords ronds).
|
||||
Vous pouvez le récupérer sur [github.com](http://github.com/yogsototh/nanoc3_blog).
|
||||
|
||||
Que pouvez-vous attendre de ce système de blog ?
|
||||
|
||||
* Tous les avantages liés à [nanoc](http://nanoc.stoneship.org) ;
|
||||
* Facilité de la gestion de plusieurs langues ;
|
||||
* coloration syntaxique des codes sources pour la plupart des languages ;
|
||||
* commentaires gérés avec [intenseDebate](http://intensedebate.org) de façon asynchrone ;
|
||||
* très portable avec ou sans javascript, XHTML Strict 1.0 / CSS3 ;
|
||||
* écrivez vos entrées au format Markdown (pas de HTML) ;
|
||||
* des améliorations typographiques (pas de ':' en début de ligne en Français par exemple),
|
||||
* entrez directement le code de graphes qui se génèreront automatiquement en image à l'aide de [Graphviz](http://graphviz.org).
|
||||
|
||||
|
||||
Pour vous donner une idée plus précise, voici la documentation que j'ai faite (en anglais) pour accompagner le code.
|
||||
|
||||
newcorps
|
||||
|
||||
# Main Documentation Page
|
||||
|
||||
Cette page est seulement en anglais désolé.
|
||||
|
||||
# Use It NOW!
|
||||
|
||||
Once installed (follow the README.md instructions).
|
||||
|
||||
<code class="zsh">
|
||||
$ cd /root/of/nanoc3_blog
|
||||
$ ./task/new_blog_entry Title of the blog
|
||||
$ vi latest.md
|
||||
$ ./task/recompile
|
||||
</code>
|
||||
|
||||
Now your website reside into the `output` directory.
|
||||
|
||||
newcorps
|
||||
|
||||
# Documentation
|
||||
|
||||
## Useful things to know
|
||||
|
||||
### Multi-language
|
||||
|
||||
All files in `multi` are processed and copied in the `content` directory.
|
||||
For each file in multi, each line starting by '`fr: `' are copied (without the `fr: ` into the `content/html/fr/` tree, but not into the `content/html/en` tree. File not starting by `fr: ` or `en: ` are copied in each destinations.
|
||||
|
||||
If you want to add another language, you'll have to modify `tasks/config`, and `config.yaml`, create a `content/html/xx` where `xx` is the language code.
|
||||
|
||||
### Edition & Rendering
|
||||
|
||||
#### additional keywords
|
||||
|
||||
You can separate multi content div using the: `n``ewcorps` directive (see examples).
|
||||
|
||||
You can create div using `b``egindiv(classname)`, `e``nddiv`. (See some existing blog entries for example). Use the class `intro` for the abstract part.
|
||||
|
||||
You can create nice description table using `<``desc>` (See source code for example).
|
||||
|
||||
#### Typography
|
||||
|
||||
In French all ':', ';', '!' and '?' are preceded automatically by ` `. This enable not to have a line starting by a single special character.
|
||||
|
||||
You can use small caps using `<sc>` tags.
|
||||
|
||||
* `(c``)` is replaced by (c).
|
||||
* `(r``)` is replaced by (r).
|
||||
* `<``-` is replaced by <-.
|
||||
* `-``>` is replaced by ->.
|
||||
|
||||
#### source code
|
||||
|
||||
To write source code you should use the following format:
|
||||
|
||||
<code class="html">
|
||||
<code class="ruby" file="filename.rb">
|
||||
The code
|
||||
</cOde>
|
||||
</code>
|
||||
|
||||
The `file` attribute is not required.
|
||||
|
||||
|
||||
### blog
|
||||
|
||||
If you want to make really long blog post, you can separate them into many files. To accomplish that, you simply have to make your files like:
|
||||
|
||||
<pre class="twilight">
|
||||
multi/blog/2010-06-01-the-title.md
|
||||
multi/blog/2010-06-01-the-title/second_part.md
|
||||
multi/blog/2010-06-01-the-title/third_part.md
|
||||
</pre>
|
||||
|
||||
|
||||
### mobileme
|
||||
|
||||
All files are intended to be generated into the `output/Scratch` directory.
|
||||
This was made like that to work nicely with iWeb organisation of websites.
|
||||
|
||||
### menu
|
||||
|
||||
The order of post is done using the `menupriority` meta-data in the header of the files.
|
||||
|
||||
You can hide some file from the menu by setting: `isHidden: true` in the header.
|
||||
|
||||
|
||||
## Details
|
||||
|
||||
To know more about this blog engine, you should look at
|
||||
[nanoc](http://nanoc.stoneship.org) project.
|
||||
|
||||
Then look at the files inside your project:
|
||||
|
||||
<desc>
|
||||
README.md : readme for the project (used by github) ::
|
||||
latest.md : symbolic link to the last blog entry ::
|
||||
multi/ : Directory containing multi-language articles ::
|
||||
tasks/ : scripts for website live ::
|
||||
config.yaml : global configuration file ::
|
||||
Rules : generation rules ::
|
||||
content/ : content files processed by nanoc ::
|
||||
layouts/ : erb templates ::
|
||||
lib/ : ruby libraries used to process files ::
|
||||
output/ : website ::
|
||||
Rakefile : not mandatory for this blog ::
|
||||
tmp
|
||||
</desc>
|
||||
|
|
@ -1 +1 @@
|
|||
./multi/blog/2010-06-14-multi-language-choices.md
|
||||
./multi/blog/2010-06-15-Get-my-blog-engine.md
|
||||
152
multi/blog/2010-06-15-Get-my-blog-engine.md
Normal file
152
multi/blog/2010-06-15-Get-my-blog-engine.md
Normal file
|
|
@ -0,0 +1,152 @@
|
|||
-----
|
||||
isHidden: false
|
||||
menupriority: 1
|
||||
kind: article
|
||||
created_at: 2010-06-15T10:56:32+02:00
|
||||
fr: title: Récupérez mon système de blog
|
||||
en: title: Get my blog engine
|
||||
author_name: Yann Esposito
|
||||
author_uri: yannesposito.com
|
||||
tags:
|
||||
- blog
|
||||
- nanoc
|
||||
-----
|
||||
|
||||
fr: J'ai publié une version *light* de mon système de blog hier soir. Par *light* il faut comprendre avec un CSS plus épuré et plus portable (sans les bords ronds).
|
||||
fr: Vous pouvez le récupérer sur [github.com](http://github.com/yogsototh/nanoc3_blog).
|
||||
en: I published a *light* version of my blog engine based on [nanoc](http://nanoc.stoneship.org) yesterday night. By *light*, I mean a lighter, more portable CSS (without round border).
|
||||
en: You can get it on [github.com](http://github.com/yogsototh/nanoc3_blog).
|
||||
|
||||
fr: Que pouvez-vous attendre de ce système de blog ?
|
||||
en: What this system provide?
|
||||
|
||||
fr: * Tous les avantages liés à [nanoc](http://nanoc.stoneship.org) ;
|
||||
fr: * Facilité de la gestion de plusieurs langues ;
|
||||
fr: * coloration syntaxique des codes sources pour la plupart des languages ;
|
||||
fr: * commentaires gérés avec [intenseDebate](http://intensedebate.org) de façon asynchrone ;
|
||||
fr: * très portable avec ou sans javascript, XHTML Strict 1.0 / CSS3 ;
|
||||
fr: * écrivez vos entrées au format Markdown (pas de HTML) ;
|
||||
fr: * des améliorations typographiques (pas de ':' en début de ligne en Français par exemple),
|
||||
fr: * entrez directement le code de graphes qui se génèreront automatiquement en image à l'aide de [Graphviz](http://graphviz.org).
|
||||
|
||||
en: * All [nanoc](http://nanoc.stoneship.org) advantages,
|
||||
en: * Easy multi-language handling,
|
||||
en: * Syntax Coloration for most languages,
|
||||
en: * [intenseDebate](http://intensedebate.org) comments integration (asynchronous) ;
|
||||
en: * Portable with and without javascript, XHTML Strict 1.0 / CSS3,
|
||||
en: * Write in markdown format (no HTML editing needed),
|
||||
en: * Typographic ameliorations (no ':' starting a line in French for example),
|
||||
en: * [Graphviz](http://graphviz.org) graph generation integration.
|
||||
|
||||
fr: Pour vous donner une idée plus précise, voici la documentation que j'ai faite (en anglais) pour accompagner le code.
|
||||
|
||||
newcorps
|
||||
|
||||
# Main Documentation Page
|
||||
|
||||
fr: Cette page est seulement en anglais désolé.
|
||||
|
||||
# Use It NOW!
|
||||
|
||||
Once installed (follow the README.md instructions).
|
||||
|
||||
<code class="zsh">
|
||||
$ cd /root/of/nanoc3_blog
|
||||
$ ./task/new_blog_entry Title of the blog
|
||||
$ vi latest.md
|
||||
$ ./task/recompile
|
||||
</code>
|
||||
|
||||
Now your website reside into the `output` directory.
|
||||
|
||||
newcorps
|
||||
|
||||
# Documentation
|
||||
|
||||
## Useful things to know
|
||||
|
||||
### Multi-language
|
||||
|
||||
All files in `multi` are processed and copied in the `content` directory.
|
||||
For each file in multi, each line starting by '`fr: `' are copied (without the `fr: ` into the `content/html/fr/` tree, but not into the `content/html/en` tree. File not starting by `fr: ` or `en: ` are copied in each destinations.
|
||||
|
||||
If you want to add another language, you'll have to modify `tasks/config`, and `config.yaml`, create a `content/html/xx` where `xx` is the language code.
|
||||
|
||||
### Edition & Rendering
|
||||
|
||||
#### additional keywords
|
||||
|
||||
You can separate multi content div using the: `n``ewcorps` directive (see examples).
|
||||
|
||||
You can create div using `b``egindiv(classname)`, `e``nddiv`. (See some existing blog entries for example). Use the class `intro` for the abstract part.
|
||||
|
||||
You can create nice description table using `<``desc>` (See source code for example).
|
||||
|
||||
#### Typography
|
||||
|
||||
In French all ':', ';', '!' and '?' are preceded automatically by ` `. This enable not to have a line starting by a single special character.
|
||||
|
||||
You can use small caps using `<sc>` tags.
|
||||
|
||||
* `(c``)` is replaced by (c).
|
||||
* `(r``)` is replaced by (r).
|
||||
* `<``-` is replaced by <-.
|
||||
* `-``>` is replaced by ->.
|
||||
|
||||
#### source code
|
||||
|
||||
To write source code you should use the following format:
|
||||
|
||||
<code class="html">
|
||||
<code class="ruby" file="filename.rb">
|
||||
The code
|
||||
</cOde>
|
||||
</code>
|
||||
|
||||
The `file` attribute is not required.
|
||||
|
||||
|
||||
### blog
|
||||
|
||||
If you want to make really long blog post, you can separate them into many files. To accomplish that, you simply have to make your files like:
|
||||
|
||||
<pre class="twilight">
|
||||
multi/blog/2010-06-01-the-title.md
|
||||
multi/blog/2010-06-01-the-title/second_part.md
|
||||
multi/blog/2010-06-01-the-title/third_part.md
|
||||
</pre>
|
||||
|
||||
|
||||
### mobileme
|
||||
|
||||
All files are intended to be generated into the `output/Scratch` directory.
|
||||
This was made like that to work nicely with iWeb organisation of websites.
|
||||
|
||||
### menu
|
||||
|
||||
The order of post is done using the `menupriority` meta-data in the header of the files.
|
||||
|
||||
You can hide some file from the menu by setting: `isHidden: true` in the header.
|
||||
|
||||
|
||||
## Details
|
||||
|
||||
To know more about this blog engine, you should look at
|
||||
[nanoc](http://nanoc.stoneship.org) project.
|
||||
|
||||
Then look at the files inside your project:
|
||||
|
||||
<desc>
|
||||
README.md : readme for the project (used by github) ::
|
||||
latest.md : symbolic link to the last blog entry ::
|
||||
multi/ : Directory containing multi-language articles ::
|
||||
tasks/ : scripts for website live ::
|
||||
config.yaml : global configuration file ::
|
||||
Rules : generation rules ::
|
||||
content/ : content files processed by nanoc ::
|
||||
layouts/ : erb templates ::
|
||||
lib/ : ruby libraries used to process files ::
|
||||
output/ : website ::
|
||||
Rakefile : not mandatory for this blog ::
|
||||
tmp
|
||||
</desc>
|
||||
Loading…
Reference in a new issue