1
0
Fork 0
forked from github/pelican
pelican-theme/docs/index.rst

83 lines
2.2 KiB
ReStructuredText
Raw Normal View History

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?
2010-12-14 15:31:11 +00: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
* Completely static output is easy to host anywhere
2010-12-14 15:31:11 +00:00
Ready to get started? Check out the :doc:`Quickstart<quickstart>` guide.
2010-12-14 15:31:11 +00:00
Features
--------
2010-12-14 15:31:11 +00:00
2021-04-21 10:16:28 +02:00
Pelicans 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)
* Publication of articles in multiple languages
2021-04-21 10:16:28 +02:00
* Generation of Atom and RSS feeds
* Code syntax highlighting
2021-04-21 10:16:28 +02:00
* Import existing content from WordPress, Dotclear, or RSS feeds
* 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
Why the name "Pelican"?
-----------------------
2010-12-14 15:31:11 +00:00
"Pelican" is an anagram for *calepin*, which means "notebook" in French. ;)
2010-12-14 15:31:11 +00:00
Source code
-----------
2010-12-14 15:31:11 +00:00
You can access the source code at: https://github.com/getpelican/pelican
2010-12-14 15:31:11 +00:00
How to get help, contribute, or provide feedback
------------------------------------------------
2010-12-14 15:31:11 +00:00
See our :doc:`feedback and contribution submission guidelines <contribute>`.
2010-12-14 15:31:11 +00:00
Documentation
-------------
.. toctree::
:maxdepth: 2
2011-08-03 22:06:10 +02:00
quickstart
install
content
publish
settings
2011-06-18 01:03:53 +02:00
plugins
2021-10-05 07:38:24 +02:00
themes
pelican-themes
2011-08-03 22:06:10 +02:00
importer
2011-01-19 16:22:15 +01:00
faq
tips
contribute
internals
2011-11-30 21:11:50 +01:00
report
2012-07-18 18:41:09 +02:00
changelog
.. Links
.. _Python: https://www.python.org/
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _Markdown: https://daringfireball.net/projects/markdown/
.. _Jinja2: https://palletsprojects.com/p/jinja/
.. _`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