2013-03-27 09:16:19 +01:00
|
|
|
|
Pelican |release|
|
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.. ifconfig:: release.endswith('.dev')
|
|
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
|
|
2018-11-02 20:53:15 -06:00
|
|
|
|
This documentation is for the version of Pelican currently under
|
|
|
|
|
|
development. Were you looking for version |last_stable| documentation?
|
2013-03-27 09:16:19 +01:00
|
|
|
|
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2014-05-12 07:48:37 -07:00
|
|
|
|
Pelican is a static site generator, written in Python_. Highlights include:
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2018-11-02 20:53:15 -06:00
|
|
|
|
* Write your content directly with your editor of choice in reStructuredText_
|
|
|
|
|
|
or Markdown_ formats
|
2013-04-16 10:13:47 -07:00
|
|
|
|
* Includes a simple CLI tool to (re)generate your site
|
|
|
|
|
|
* Easy to interface with distributed version control systems and web hooks
|
2012-03-06 06:13:17 -08:00
|
|
|
|
* Completely static output is easy to host anywhere
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2014-05-12 07:48:37 -07:00
|
|
|
|
Ready to get started? Check out the :doc:`Quickstart<quickstart>` guide.
|
|
|
|
|
|
|
2010-12-14 15:31:11 +00:00
|
|
|
|
Features
|
2012-08-06 07:40:10 -07:00
|
|
|
|
--------
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2021-04-21 10:16:28 +02:00
|
|
|
|
Pelican’s feature highlights include:
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2013-04-16 10:13:47 -07:00
|
|
|
|
* Articles (e.g., blog posts) and pages (e.g., "About", "Projects", "Contact")
|
2021-04-21 10:16:28 +02:00
|
|
|
|
* Integration with external services
|
|
|
|
|
|
* Site themes (created using Jinja2_ templates)
|
2012-03-06 06:13:17 -08:00
|
|
|
|
* Publication of articles in multiple languages
|
2021-04-21 10:16:28 +02:00
|
|
|
|
* Generation of Atom and RSS feeds
|
2012-03-06 06:13:17 -08:00
|
|
|
|
* Code syntax highlighting
|
2021-04-21 10:16:28 +02:00
|
|
|
|
* Import existing content from WordPress, Dotclear, or RSS feeds
|
2014-05-12 07:48:37 -07:00
|
|
|
|
* Fast rebuild times thanks to content caching and selective output writing
|
2021-04-21 10:16:28 +02:00
|
|
|
|
* Extensible via a rich plugin ecosystem: `Pelican Plugins`_
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2012-08-01 18:20:12 -07:00
|
|
|
|
Why the name "Pelican"?
|
2012-08-06 07:40:10 -07:00
|
|
|
|
-----------------------
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2012-08-04 11:15:44 -07:00
|
|
|
|
"Pelican" is an anagram for *calepin*, which means "notebook" in French. ;)
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
|
|
|
|
|
Source code
|
2012-08-06 07:40:10 -07:00
|
|
|
|
-----------
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2012-08-04 11:15:44 -07:00
|
|
|
|
You can access the source code at: https://github.com/getpelican/pelican
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2014-05-26 12:32:05 +02:00
|
|
|
|
How to get help, contribute, or provide feedback
|
|
|
|
|
|
------------------------------------------------
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2014-05-26 12:32:05 +02:00
|
|
|
|
See our :doc:`feedback and contribution submission guidelines <contribute>`.
|
2010-12-14 15:31:11 +00:00
|
|
|
|
|
2010-12-15 18:01:29 +00:00
|
|
|
|
Documentation
|
2012-08-06 07:40:10 -07:00
|
|
|
|
-------------
|
2010-12-15 18:01:29 +00:00
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
|
:maxdepth: 2
|
2011-08-03 22:06:10 +02:00
|
|
|
|
|
2014-05-12 07:48:37 -07:00
|
|
|
|
quickstart
|
|
|
|
|
|
install
|
|
|
|
|
|
content
|
|
|
|
|
|
publish
|
2010-12-15 18:01:29 +00:00
|
|
|
|
settings
|
2011-06-18 01:03:53 +02:00
|
|
|
|
plugins
|
2021-10-05 07:38:24 +02:00
|
|
|
|
themes
|
2011-07-22 02:12:10 +02:00
|
|
|
|
pelican-themes
|
2011-08-03 22:06:10 +02:00
|
|
|
|
importer
|
2011-01-19 16:22:15 +01:00
|
|
|
|
faq
|
2011-08-19 23:01:01 +02:00
|
|
|
|
tips
|
2011-05-10 23:41:27 +01:00
|
|
|
|
contribute
|
2014-05-12 07:48:37 -07:00
|
|
|
|
internals
|
2011-11-30 21:11:50 +01:00
|
|
|
|
report
|
2012-07-18 18:41:09 +02:00
|
|
|
|
changelog
|
2012-08-06 07:40:10 -07:00
|
|
|
|
|
|
|
|
|
|
.. Links
|
|
|
|
|
|
|
2019-04-25 15:08:04 +02:00
|
|
|
|
.. _Python: https://www.python.org/
|
2012-08-06 07:40:10 -07:00
|
|
|
|
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
|
2019-04-25 15:08:04 +02:00
|
|
|
|
.. _Markdown: https://daringfireball.net/projects/markdown/
|
2020-04-12 09:38:35 -05:00
|
|
|
|
.. _Jinja2: https://palletsprojects.com/p/jinja/
|
2019-04-25 15:08:04 +02:00
|
|
|
|
.. _`Pelican documentation`: https://docs.getpelican.com/latest/
|
|
|
|
|
|
.. _`Pelican's internals`: https://docs.getpelican.com/en/latest/internals.html
|
2021-04-21 10:16:28 +02:00
|
|
|
|
.. _`Pelican Plugins`: https://github.com/pelican-plugins
|