Static site generator that supports Markdown and reST syntax. Powered by Python.
  • Python 85.3%
  • CSS 8.7%
  • Jinja 6%
Find a file
Romain Porte 35bbda4507 templates/tasks.py: livereload: automatically open browser
When the livereload target is invoked, a web brower will be
automatically opened pointing to the locally-served website.

In case of no web browser can be found by the module, the open call
returns False but no exception is raised. This means that it is still
possible to call livereload on a remote machine and access it without
any error being triggered.

Signed-off-by: Romain Porte <microjoe@microjoe.org>
2021-04-19 13:52:04 +02:00
.github Make Tox & GitHub CI jobs' Python versions match 2021-03-23 08:23:07 +01:00
docs Release Pelican 4.6.0 2021-03-23 10:31:21 +00:00
pelican templates/tasks.py: livereload: automatically open browser 2021-04-19 13:52:04 +02:00
requirements Relax dependency minimum versions 2021-03-23 08:06:58 +01:00
samples Modernize code base to Python 3+ syntax 2020-04-27 09:45:31 +02:00
.coveragerc [coveralls] Exclude tests from coverage 2014-06-24 22:29:36 +01:00
.editorconfig Add .yaml file extension to EditorConfig 2021-02-18 15:06:29 +01:00
.gitattributes Add missing .gitattributes attributes. Refs #2069 2016-12-23 08:03:57 -08:00
.gitignore Add poetry.lock to list of files for Git to ignore 2020-04-12 15:21:17 +02:00
.mailmap .mailmap: Add mappings to consolidate author names and emails 2013-04-12 10:51:48 -04:00
.pre-commit-config.yaml Only run Flake8 on changed lines 2020-04-30 21:43:31 +02:00
CONTRIBUTING.rst Prefix Pip commands with python -m in docs 2020-08-17 07:04:00 +02:00
LICENSE Update links to HTTPS and current 301 redirects in docs/templates/themes (#2661) 2020-04-12 16:38:35 +02:00
MANIFEST.in MANIFEST.in include jinja2 templates 2020-08-24 22:34:02 +09:00
pyproject.toml Release Pelican 4.6.0 2021-03-23 10:31:21 +00:00
README.rst Update PyPI URLs to new equivalents 2020-11-20 15:46:05 +01:00
setup.cfg Revert setup.py changes. Ensure universal wheels. 2014-07-01 14:33:04 -07:00
setup.py Release Pelican 4.6.0 2021-03-23 10:31:21 +00:00
tasks.py Make PKG_PATH var in Invoke tasks.py more DRY 2021-02-18 12:29:18 +01:00
THANKS Invoke template : avoiding to spawn unnecessary process + passing-through CLI args to pelican 2020-06-09 16:01:46 +02:00
tox.ini Make Tox & GitHub CI jobs' Python versions match 2021-03-23 08:23:07 +01:00

Pelican |build-status| |pypi-version| |repology|
================================================

Pelican is a static site generator, written in Python_.

* Write content in reStructuredText_ or Markdown_ using your editor of choice
* Includes a simple command line tool to (re)generate site files
* Easy to interface with version control systems and web hooks
* Completely static output is simple to host anywhere


Features
--------

Pelican currently supports:

* Chronological content (e.g., articles, blog posts) as well as static pages
* Integration with external services (e.g., Google Analytics and Disqus)
* Site themes (created using Jinja2_ templates)
* Publication of articles in multiple languages
* Generation of Atom and RSS feeds
* Syntax highlighting via Pygments_
* Importing existing content from WordPress, Dotclear, and other services
* Fast rebuild times due to content caching and selective output writing

Check out `Pelican's documentation`_ for further information.


How to get help, contribute, or provide feedback
------------------------------------------------

See our `contribution submission and feedback guidelines <CONTRIBUTING.rst>`_.


Source code
-----------

Pelican's source code is `hosted on GitHub`_. If you feel like hacking,
take a look at `Pelican's internals`_.


Why the name "Pelican"?
-----------------------

"Pelican" is an anagram of *calepin*, which means "notebook" in French.


.. 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/
.. _Pygments: https://pygments.org/
.. _`Pelican's documentation`: https://docs.getpelican.com/
.. _`Pelican's internals`: https://docs.getpelican.com/en/latest/internals.html
.. _`hosted on GitHub`: https://github.com/getpelican/pelican

.. |build-status| image:: https://img.shields.io/github/workflow/status/getpelican/pelican/build
   :target: https://github.com/getpelican/pelican/actions
   :alt: GitHub Actions CI: continuous integration status
.. |pypi-version| image:: https://img.shields.io/pypi/v/pelican.svg
   :target: https://pypi.org/project/pelican/
   :alt: PyPI: the Python Package Index
.. |repology| image:: https://repology.org/badge/tiny-repos/pelican.svg
   :target: https://repology.org/project/pelican/versions
   :alt: Repology: the packaging hub