forked from github/pelican
a5edbf8546
Competing static site generators integrate the functionality of regenerating content and serving it into their main executable. In pelican this functionality used to be in an external script `develop_server.sh` which resides in the blog base directory. This has the disadvantage that changes in pelican can break the `develop_server.sh` scripts which will not automatically be upgraded together with pelican by package managers. Thus, pelican should integrate this functionality into its main executable. To this end, this commit removes `develop_server.sh` and adds three command line options to the pelican executable: * `-l/--listen` starts the HTTP server (`-s/--serve` was already taken) * `-p/--port` specifies the port to listen at * `-b/--bind` specifies the IP to bind to `--listen` and `--autoreload` can be used together to achieve the same effect that other static site generators offer: Serve files via HTTP while at the same time auto-generating the content. Since the `develop_server.sh` script was removed, pelican-quickstart looses the `develop` option. Since the `develop_server.sh` script was removed, the Makefile looses the `stopserver` target and the `devserver` target is replaced by running `pelican -l` in the foreground. Since pelican now offers the `--listen` option, the fabfile uses that instead of starting the socketserver itself.
81 lines
2.4 KiB
ReStructuredText
81 lines
2.4 KiB
ReStructuredText
Quickstart
|
|
##########
|
|
|
|
Reading through all the documentation is highly recommended, but for the truly
|
|
impatient, following are some quick steps to get started.
|
|
|
|
Installation
|
|
------------
|
|
|
|
Install Pelican (and optionally Markdown if you intend to use it) on Python
|
|
2.7.x or Python 3.3+ by running the following command in your preferred
|
|
terminal, prefixing with ``sudo`` if permissions warrant::
|
|
|
|
pip install pelican markdown
|
|
|
|
Create a project
|
|
----------------
|
|
|
|
First, choose a name for your project, create an appropriately-named directory
|
|
for your site, and switch to that directory::
|
|
|
|
mkdir -p ~/projects/yoursite
|
|
cd ~/projects/yoursite
|
|
|
|
Create a skeleton project via the ``pelican-quickstart`` command, which begins
|
|
by asking some questions about your site::
|
|
|
|
pelican-quickstart
|
|
|
|
For questions that have default values denoted in brackets, feel free to use
|
|
the Return key to accept those default values [#tzlocal_fn]_. When asked for
|
|
your URL prefix, enter your domain name as indicated (e.g.,
|
|
``http://example.com``).
|
|
|
|
Create an article
|
|
-----------------
|
|
|
|
You cannot run Pelican until you have created some content. Use your preferred
|
|
text editor to create your first article with the following content::
|
|
|
|
Title: My First Review
|
|
Date: 2010-12-03 10:20
|
|
Category: Review
|
|
|
|
Following is a review of my favorite mechanical keyboard.
|
|
|
|
Given that this example article is in Markdown format, save it as
|
|
``~/projects/yoursite/content/keyboard-review.md``.
|
|
|
|
Generate your site
|
|
------------------
|
|
|
|
From your site directory, run the ``pelican`` command to generate your site::
|
|
|
|
pelican content
|
|
|
|
Your site has now been generated inside the ``output`` directory. (You may see a
|
|
warning related to feeds, but that is normal when developing locally and can be
|
|
ignored for now.)
|
|
|
|
Preview your site
|
|
-----------------
|
|
|
|
Open a new terminal session, navigate to your site directory and run the
|
|
following command to launch Pelican's web server::
|
|
|
|
pelican --listen
|
|
|
|
Preview your site by navigating to http://localhost:8000/ in your browser.
|
|
|
|
Continue reading the other documentation sections for more detail, and check out
|
|
the Pelican wiki's Tutorials_ page for links to community-published tutorials.
|
|
|
|
.. _Tutorials: https://github.com/getpelican/pelican/wiki/Tutorials
|
|
|
|
Footnotes
|
|
---------
|
|
|
|
.. [#tzlocal_fn] You can help localize default fields by installing the
|
|
optional `tzlocal <https://pypi.python.org/pypi/tzlocal>`_
|
|
module.
|