mirror of
https://github.com/getpelican/pelican.git
synced 2025-10-15 20:28:56 +02:00
Merge 8378c0df5e into c2b2def1c8
This commit is contained in:
commit
429454b11c
3 changed files with 49 additions and 49 deletions
|
|
@ -172,13 +172,13 @@ on all operating systems, including Windows.
|
|||
For example, a Pelican project might be structured like this::
|
||||
|
||||
website/
|
||||
├── content
|
||||
│ ├── category/
|
||||
│ │ └── article1.rst
|
||||
│ ├── article2.md
|
||||
│ └── pages
|
||||
│ └── about.md
|
||||
└── pelican.conf.py
|
||||
|-- content
|
||||
| |-- category/
|
||||
| | `-- article1.rst
|
||||
| |-- article2.md
|
||||
| `-- pages
|
||||
| `-- about.md
|
||||
`-- pelican.conf.py
|
||||
|
||||
In this example, ``article1.rst`` could look like this::
|
||||
|
||||
|
|
@ -216,12 +216,12 @@ broken links.
|
|||
For example, a project's content directory might be structured like this::
|
||||
|
||||
content
|
||||
├── images
|
||||
│ └── han.jpg
|
||||
├── pdfs
|
||||
│ └── menu.pdf
|
||||
└── pages
|
||||
└── test.md
|
||||
|-- images
|
||||
| `-- han.jpg
|
||||
|-- pdfs
|
||||
| `-- menu.pdf
|
||||
`-- pages
|
||||
`-- test.md
|
||||
|
||||
``test.md`` would include::
|
||||
|
||||
|
|
@ -271,13 +271,13 @@ a directory included in the ``STATIC_PATHS`` setting.
|
|||
For example, a project's content directory might be structured like this::
|
||||
|
||||
content
|
||||
├── blog
|
||||
│ ├── icons
|
||||
│ │ └── icon.png
|
||||
│ ├── photo.jpg
|
||||
│ └── testpost.md
|
||||
└── downloads
|
||||
└── archive.zip
|
||||
|-- blog
|
||||
| |-- icons
|
||||
| | `-- icon.png
|
||||
| |-- photo.jpg
|
||||
| `-- testpost.md
|
||||
`-- downloads
|
||||
`-- archive.zip
|
||||
|
||||
``pelicanconf.py`` would include::
|
||||
|
||||
|
|
@ -300,12 +300,12 @@ For example, a project's content directory might be structured like this::
|
|||
Site generation would then produce an output directory structured like this::
|
||||
|
||||
output
|
||||
└── 2014
|
||||
├── archive.zip
|
||||
├── icons
|
||||
│ └── icon.png
|
||||
├── photo.jpg
|
||||
└── test-post.html
|
||||
`-- 2014
|
||||
|-- archive.zip
|
||||
|-- icons
|
||||
| `-- icon.png
|
||||
|-- photo.jpg
|
||||
`-- test-post.html
|
||||
|
||||
Notice that all the files linked using ``{attach}`` ended up in or beneath
|
||||
the article's output directory.
|
||||
|
|
|
|||
|
|
@ -100,14 +100,14 @@ following hierarchy (except for *pages* — shown in parentheses below — which
|
|||
can optionally add yourself if you plan to create non-chronological content)::
|
||||
|
||||
yourproject/
|
||||
├── content
|
||||
│ └── (pages)
|
||||
├── output
|
||||
├── develop_server.sh
|
||||
├── fabfile.py
|
||||
├── Makefile
|
||||
├── pelicanconf.py # Main settings file
|
||||
└── publishconf.py # Settings to use when ready to publish
|
||||
|-- content
|
||||
| `-- (pages)
|
||||
|-- output
|
||||
|-- develop_server.sh
|
||||
|-- fabfile.py
|
||||
|-- Makefile
|
||||
|-- pelicanconf.py # Main settings file
|
||||
`-- publishconf.py # Settings to use when ready to publish
|
||||
|
||||
The next step is to begin to adding content to the *content* folder that has
|
||||
been created for you.
|
||||
|
|
|
|||
|
|
@ -22,21 +22,21 @@ Structure
|
|||
|
||||
To make your own theme, you must follow the following structure::
|
||||
|
||||
├── static
|
||||
│ ├── css
|
||||
│ └── images
|
||||
└── templates
|
||||
├── archives.html // to display archives
|
||||
├── period_archives.html // to display time-period archives
|
||||
├── article.html // processed for each article
|
||||
├── author.html // processed for each author
|
||||
├── authors.html // must list all the authors
|
||||
├── categories.html // must list all the categories
|
||||
├── category.html // processed for each category
|
||||
├── index.html // the index (list all the articles)
|
||||
├── page.html // processed for each page
|
||||
├── tag.html // processed for each tag
|
||||
└── tags.html // must list all the tags. Can be a tag cloud.
|
||||
|-- static
|
||||
| |-- css
|
||||
| `-- images
|
||||
`-- templates
|
||||
|-- archives.html // to display archives
|
||||
|-- period_archives.html // to display time-period archives
|
||||
|-- article.html // processed for each article
|
||||
|-- author.html // processed for each author
|
||||
|-- authors.html // must list all the authors
|
||||
|-- categories.html // must list all the categories
|
||||
|-- category.html // processed for each category
|
||||
|-- index.html // the index (list all the articles)
|
||||
|-- page.html // processed for each page
|
||||
|-- tag.html // processed for each tag
|
||||
`-- tags.html // must list all the tags. Can be a tag cloud.
|
||||
|
||||
* `static` contains all the static assets, which will be copied to the output
|
||||
`theme` folder. The above filesystem layout includes CSS and image folders,
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue