Fix spaces at end of line
This commit is contained in:
Solene Rapenne
parent
8f68de9add
commit
25c83f1ce1
91
README.md
91
README.md
|
|
@ -11,9 +11,8 @@ It runs without Quicklisp.
|
|||
## Showcase
|
||||
|
||||
I am using cl-yag to create and maintain my websites in the
|
||||
world-wide-web (visit: *[Solene's
|
||||
percent](https://dataswamp.org/~solene/)*) as well as [in
|
||||
gopher-space](gopher://dataswamp.org/1/~solene/).
|
||||
world-wide-web (visit: *[Solene'spercent](https://dataswamp.org/~solene/)*)
|
||||
as well as [in gopher-space](gopher://dataswamp.org/1/~solene/).
|
||||
|
||||
|
||||
## Requirements
|
||||
|
|
@ -44,28 +43,28 @@ Read in the follwing section where to find it.
|
|||
After cloning the repository, your project's directory should contain at
|
||||
least the following files and folders:
|
||||
|
||||
.
|
||||
|-- LICENSE
|
||||
|-- Makefile
|
||||
|-- README.md
|
||||
|-- data/
|
||||
| |-- 1.md
|
||||
| |-- README.md
|
||||
| `-- articles.lisp
|
||||
|-- generator.lisp
|
||||
|-- output/
|
||||
| |-- gopher/
|
||||
| `-- html/
|
||||
|-- static/
|
||||
| |-- css/style.css
|
||||
| `-- img/
|
||||
`-- templates/
|
||||
|-- article.tpl
|
||||
|-- gopher_head.tpl
|
||||
|-- layout.tpl
|
||||
|-- one-tag.tpl
|
||||
|-- rss-item.tpl
|
||||
`-- rss.tpl
|
||||
.
|
||||
|-- LICENSE
|
||||
|-- Makefile
|
||||
|-- README.md
|
||||
|-- data/
|
||||
| |-- 1.md
|
||||
| |-- README.md
|
||||
| `-- articles.lisp
|
||||
|-- generator.lisp
|
||||
|-- output/
|
||||
| |-- gopher/
|
||||
| `-- html/
|
||||
|-- static/
|
||||
| |-- css/style.css
|
||||
| `-- img/
|
||||
`-- templates/
|
||||
|-- article.tpl
|
||||
|-- gopher_head.tpl
|
||||
|-- layout.tpl
|
||||
|-- one-tag.tpl
|
||||
|-- rss-item.tpl
|
||||
`-- rss.tpl
|
||||
|
||||
- **Makefile**
|
||||
- This file exists to simplifiy the recurring execution of frequently used commands.
|
||||
|
|
@ -73,14 +72,14 @@ least the following files and folders:
|
|||
- This is cl-yag's core library.
|
||||
- **static/**
|
||||
- This directory holds content, that needs to be published without being changed (e.g. stylesheets, js-scripts).
|
||||
- If you come from 'non-static CMS'-Country: 'static/' holds, what you would put in your 'assets/' directory.
|
||||
- If you come from 'non-static CMS'-Country: 'static/' holds, what you would put in your 'assets/' directory.
|
||||
- **templates/**
|
||||
- The templates in this directory provide the structural skeleton(s) of the webpages and feeds you want to create.
|
||||
- **output/**
|
||||
- cl-yag puts in this directory everything ready to get deployed.
|
||||
- Because cl-yag generates not only HTML, but gopher-compliant pages as well, output/ **holds two subdirectories**.
|
||||
- **gopher/** : contains the website for gopher,
|
||||
- **html/** : contains the website in HTML.
|
||||
- Because cl-yag generates not only HTML, but gopher-compliant pages as well, output/ **holds two subdirectories**.
|
||||
- **gopher/** : contains the website for gopher,
|
||||
- **html/** : contains the website in HTML.
|
||||
|
||||
And there is the **data/** directory, which is important enough to get a subsubsection of its own.
|
||||
|
||||
|
|
@ -117,15 +116,15 @@ The **config** variable is used to assign the following values:
|
|||
|
||||
- **:webmaster**
|
||||
- The name of the default(!) author.
|
||||
- :webmaster gets used, if **:author** is omitted. (see below: 'The **articles** variable'.)
|
||||
- :webmaster gets used, if **:author** is omitted. (see below: 'The **articles** variable'.)
|
||||
- **:title**
|
||||
- The title of the webpage
|
||||
- **:description**
|
||||
- This text is used in the *description* field of the Atom RSS
|
||||
- **:url**
|
||||
- This needs to be the full(!) URL of your website, including(!) a final slash.
|
||||
- MIND: If the url contains a tilde (~), it needs to get duplicated
|
||||
- Example: https://mydomain/~~user/ is a valid url.
|
||||
- MIND: If the url contains a tilde (~), it needs to get duplicated
|
||||
- Example: https://mydomain/~~user/ is a valid url.
|
||||
- **:rss-item-number**
|
||||
- This holds the number of latest(!) RSS items you want to get published when you generate the files.
|
||||
- **html**
|
||||
|
|
@ -146,19 +145,19 @@ The **articles** variable holds per page/post-metadata.
|
|||
Of the following fields, only the *:author* and *:short* description could be omitted.
|
||||
|
||||
- **:short**
|
||||
- The _:short_ field's value is used for displaying a really short description of the posts content on your homepage.
|
||||
- If _:short_ doesn't get a value, the full article gets displayed.
|
||||
- Hint: Use ``:short "view the article for the full text"``, if you don't want to display the full text of an article on your index site.
|
||||
- The _:short_ field's value is used for displaying a really short description of the posts content on your homepage.
|
||||
- If _:short_ doesn't get a value, the full article gets displayed.
|
||||
- Hint: Use ``:short "view the article for the full text"``, if you don't want to display the full text of an article on your index site.
|
||||
- **:id_**
|
||||
- The _:id_ field holds the filename of your post/page.
|
||||
- Example: ``:id "2"`` will load file ``data/2.md``. Use text instead of numbers, if you want to.
|
||||
- (See section: 'The **data/** Directory'.)
|
||||
- Example: ``:id "2"`` will load file ``data/2.md``. Use text instead of numbers, if you want to.
|
||||
- (See section: 'The **data/** Directory'.)
|
||||
- **:author**
|
||||
- The _:author_ field is used to display the article' author.
|
||||
- If you omit it, the generator will take the name from the **:webmaster** field of the *config* variable.
|
||||
- **:tag**
|
||||
- _:tag_ field is used to create a "view" containing all articles of the same tag.
|
||||
- MIND: Whitespaces are not allowed in(!) tags.
|
||||
- MIND: Whitespaces are not allowed in(!) tags.
|
||||
|
||||
|
||||
## Howto Create A New Post
|
||||
|
|
@ -166,11 +165,11 @@ Of the following fields, only the *:author* and *:short* description could be om
|
|||
Edit data/articles.lisp and add a new list to the *articles* variable:
|
||||
|
||||
(list :title "How do I use cl-yag"
|
||||
:id "2"
|
||||
:date "29 April 2016"
|
||||
:author "Solène"
|
||||
:short "I will explain how to use the generator"
|
||||
:tag "example help code")
|
||||
:id "2"
|
||||
:date "29 April 2016"
|
||||
:author "Solène"
|
||||
:short "I will explain how to use the generator"
|
||||
:tag "example help code")
|
||||
|
||||
Then write a corresponding ``2.md`` file, using markdown.
|
||||
|
||||
|
|
@ -206,7 +205,7 @@ cl-yags default Lisp interpreter is **sbcl**.
|
|||
If you want to use a different lisp interpreter you need to set the
|
||||
variable 'LISP' to the name of your binary, when calling ``make``.
|
||||
|
||||
`make LISP=ecl`
|
||||
make LISP=ecl
|
||||
|
||||
|
||||
### Using git Hooks For Publishing
|
||||
|
|
@ -227,7 +226,7 @@ Here is an example code, if you want to include another page in the template:
|
|||
3. Modify the function *generate-layout* in cl-yag's **generator.lisp** accordingly.
|
||||
This is done by adding the following template function call:
|
||||
|
||||
"**(template "%%Panel%%" (load-file "template/panel.tpl"))**"
|
||||
(template "%%Panel%%" (load-file "template/panel.tpl"))
|
||||
|
||||
(Note: You can insert your text directly into the layout template file
|
||||
as well.)
|
||||
|
|
@ -275,4 +274,4 @@ If you want to contribute, feel free to contact me and/or to send in a patch.
|
|||
- If you are looking for a way to contribute:
|
||||
- You could find a way to "sanitize" cl-yag's behaviour regarding the tilde (see: above);
|
||||
- Also see: 'Note' in 'Posting Without Tagging';
|
||||
- Also see: 'A Note On Themes.
|
||||
- Also see: 'A Note On Themes.
|
||||
|
|
|
|||
Loading…
Reference in New Issue