Improve English documentation with enhanced clarity, grammar, and spelling

This commit is contained in:
Justin Mayer 2012-03-06 06:13:17 -08:00
commit bde06c4011
11 changed files with 429 additions and 403 deletions

View file

@ -1,57 +1,58 @@
Pelican
#######
Pelican is a simple weblog generator, written in python.
Pelican is a simple weblog generator, written in Python.
* Write your weblog entries directly with your editor of choice (vim!) and
directly in restructured text, or markdown.
* A simple cli-tool to (re)generate the weblog.
* Write your weblog entries directly with your editor of choice (vim!) in
reStructuredText or Markdown
* A simple CLI tool to (re)generate the weblog
* Easy to interface with DVCSes and web hooks
* Completely static output, so easy to host anywhere !
* Completely static output is easy to host anywhere
Features
========
Pelican currently supports:
* blog articles and simple pages
* comments, via an external service (disqus). Please notice that while
it's useful, it's an external service, and you'll not manage the
comments by yourself. It could potentially eat your data. (optional)
* easy theming (themes are done using `jinja2 <http://jinja.pocoo.org>`_)
* PDF generation of the articles/pages (optional).
* publication of articles in various languages
* RSS/Atom feeds
* wordpress/dotclear or RSS imports
* integration with various tools: twitter/google analytics (optional)
* Blog articles and pages
* Comments, via an external service (Disqus). (Please note that while
useful, Disqus is an external service, and thus the comment data will be
somewhat outside of your control and potentially subject to data loss.)
* Theming support (themes are created using `jinja2 <http://jinja.pocoo.org/>`_)
* PDF generation of the articles/pages (optional)
* Publication of articles in multiple languages
* Atom/RSS feeds
* Code syntax highlighting
* Import from WordPress, Dotclear, or RSS feeds
* Integration with external tools: Twitter, Google Analytics, etc. (optional)
Why the name "Pelican" ?
========================
Heh, you didn't noticed? "Pelican" is an anagram for "Calepin" ;)
Heh, you didn't notice? "Pelican" is an anagram for "Calepin" ;)
Source code
===========
You can access the source code via git on http://github.com/ametaireau/pelican/
You can access the source code via git at http://github.com/ametaireau/pelican/
Feedback / Contact us
=====================
If you want to see new features in Pelican, dont hesitate to tell me, to clone
If you want to see new features in Pelican, don't hesitate to tell me, to clone
the repository, etc. That's open source, dude!
Contact me at "alexis at notmyidea dot org" for any request/feedback! You can
also join the team at `#pelican on irc.freenode.org
<irc://irc.freenode.net/pelican>`_
(or if you don't have any IRC client, using `the webchat
(or if you don't have any IRC client, use `the webchat
<http://webchat.freenode.net/?channels=pelican&uio=d4>`_)
for quick feedback.
Documentation
=============
A french version of the documentation is available at :doc:`fr/index`.
A French version of the documentation is available at :doc:`fr/index`.
.. toctree::
:maxdepth: 2