5 |
6 | {% include 'twitter.html' %}
9 |
10 | {% include 'article_infos.html' %}
11 | {{ article.content }}
12 |
13 | {% if DISQUS_SITENAME %}
14 |
26 | {% endif %}
27 |
28 |
29 |
30 | {% endblock %}
31 |
--------------------------------------------------------------------------------
/pelican/themes/notmyidea/static/css/reset.css:
--------------------------------------------------------------------------------
1 | /*
2 | Name: Reset Stylesheet
3 | Description: Resets browser's default CSS
4 | Author: Eric Meyer
5 | Author URI: http://meyerweb.com/eric/tools/css/reset/
6 | */
7 |
8 | /* v1.0 | 20080212 */
9 | html, body, div, span, applet, object, iframe,
10 | h1, h2, h3, h4, h5, h6, p, blockquote, pre,
11 | a, abbr, acronym, address, big, cite, code,
12 | del, dfn, em, font, img, ins, kbd, q, s, samp,
13 | small, strike, strong, sub, sup, tt, var,
14 | b, u, i, center,
15 | dl, dt, dd, ol, ul, li,
16 | fieldset, form, label, legend,
17 | table, caption, tbody, tfoot, thead, tr, th, td {
18 | background: transparent;
19 | border: 0;
20 | font-size: 100%;
21 | margin: 0;
22 | outline: 0;
23 | padding: 0;
24 | vertical-align: baseline;
25 | }
26 |
27 | body {line-height: 1;}
28 |
29 | ol, ul {list-style: none;}
30 |
31 | blockquote, q {quotes: none;}
32 |
33 | blockquote:before, blockquote:after,
34 | q:before, q:after {
35 | content: '';
36 | content: none;
37 | }
38 |
39 | /* remember to define focus styles! */
40 | :focus {
41 | outline: 0;
42 | }
43 |
44 | /* remember to highlight inserts somehow! */
45 | ins {text-decoration: none;}
46 | del {text-decoration: line-through;}
47 |
48 | /* tables still need 'cellspacing="0"' in the markup */
49 | table {
50 | border-collapse: collapse;
51 | border-spacing: 0;
52 | }
--------------------------------------------------------------------------------
/setup.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python
2 | from setuptools import setup
3 | import sys
4 |
5 | VERSION = "2.7.2" # find a better way to do so.
6 |
7 | requires = ['feedgenerator', 'jinja2', 'pygments', 'docutils', 'pytz']
8 | if sys.version_info < (2,7):
9 | requires.append('argparse')
10 |
11 | setup(
12 | name = "pelican",
13 | version = VERSION,
14 | url = 'http://alexis.notmyidea.org/pelican/',
15 | author = 'Alexis Metaireau',
16 | author_email = 'alexis@notmyidea.org',
17 | description = "A tool to generate a static blog, with restructured text (or markdown) input files.",
18 | long_description=open('README.rst').read(),
19 | packages = ['pelican'],
20 | include_package_data = True,
21 | install_requires = requires,
22 | scripts = ['bin/pelican', 'tools/pelican-themes', 'tools/pelican-import', 'tools/pelican-quickstart'],
23 | classifiers = ['Development Status :: 5 - Production/Stable',
24 | 'Environment :: Console',
25 | 'License :: OSI Approved :: GNU Affero General Public License v3',
26 | 'Operating System :: OS Independent',
27 | 'Programming Language :: Python',
28 | 'Topic :: Internet :: WWW/HTTP',
29 | 'Topic :: Software Development :: Libraries :: Python Modules',
30 | ],
31 | )
32 |
--------------------------------------------------------------------------------
/tests/test_settings.py:
--------------------------------------------------------------------------------
1 | import unittest2
2 | from os.path import dirname, abspath, join
3 |
4 | from pelican.settings import read_settings, _DEFAULT_CONFIG
5 |
6 |
7 | class TestSettingsFromFile(unittest2.TestCase):
8 | """Providing a file, it should read it, replace the default values and
9 | append new values to the settings, if any
10 | """
11 | def setUp(self):
12 | self.PATH = abspath(dirname(__file__))
13 | default_conf = join(self.PATH, 'default_conf.py')
14 | self.settings = read_settings(default_conf)
15 |
16 | def test_overwrite_existing_settings(self):
17 | self.assertEqual(self.settings.get('SITENAME'), u"Alexis' log")
18 | self.assertEqual(self.settings.get('SITEURL'),
19 | 'http://blog.notmyidea.org')
20 |
21 | def test_keep_default_settings(self):
22 | """keep default settings if not defined"""
23 | self.assertEqual(self.settings.get('DEFAULT_CATEGORY'),
24 | _DEFAULT_CONFIG['DEFAULT_CATEGORY'])
25 |
26 | def test_dont_copy_small_keys(self):
27 | """do not copy keys not in caps."""
28 | self.assertNotIn('foobar', self.settings)
29 |
30 | def test_read_empty_settings(self):
31 | """providing no file should return the default values."""
32 | settings = read_settings(None)
33 | self.assertDictEqual(settings, _DEFAULT_CONFIG)
34 |
--------------------------------------------------------------------------------
/samples/pelican.conf.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 | AUTHOR = u'Alexis Métaireau'
3 | SITENAME = u"Alexis' log"
4 | SITEURL = 'http://blog.notmyidea.org'
5 |
6 | GITHUB_URL = 'http://github.com/ametaireau/'
7 | DISQUS_SITENAME = "blog-notmyidea"
8 | PDF_GENERATOR = False
9 | REVERSE_CATEGORY_ORDER = True
10 | LOCALE = ""
11 | DEFAULT_PAGINATION = 2
12 |
13 | FEED_RSS = 'feeds/all.rss.xml'
14 | CATEGORY_FEED_RSS = 'feeds/%s.rss.xml'
15 |
16 | LINKS = (('Biologeek', 'http://biologeek.org'),
17 | ('Filyb', "http://filyb.info/"),
18 | ('Libert-fr', "http://www.libert-fr.com"),
19 | ('N1k0', "http://prendreuncafe.com/blog/"),
20 | (u'Tarek Ziadé', "http://ziade.org/blog"),
21 | ('Zubin Mithra', "http://zubin71.wordpress.com/"),)
22 |
23 | SOCIAL = (('twitter', 'http://twitter.com/ametaireau'),
24 | ('lastfm', 'http://lastfm.com/user/akounet'),
25 | ('github', 'http://github.com/ametaireau'),)
26 |
27 | # global metadata to all the contents
28 | DEFAULT_METADATA = (('yeah', 'it is'),)
29 |
30 | # static paths will be copied under the same name
31 | STATIC_PATHS = ["pictures",]
32 |
33 | # A list of files to copy from the source to the destination
34 | FILES_TO_COPY = (('extra/robots.txt', 'robots.txt'),)
35 |
36 | # foobar will not be used, because it's not in caps. All configuration keys
37 | # have to be in caps
38 | foobar = "barbaz"
39 |
--------------------------------------------------------------------------------
/tests/default_conf.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 | AUTHOR = u'Alexis Métaireau'
3 | SITENAME = u"Alexis' log"
4 | SITEURL = 'http://blog.notmyidea.org'
5 |
6 | GITHUB_URL = 'http://github.com/ametaireau/'
7 | DISQUS_SITENAME = "blog-notmyidea"
8 | PDF_GENERATOR = False
9 | REVERSE_CATEGORY_ORDER = True
10 | LOCALE = ""
11 | DEFAULT_PAGINATION = 2
12 |
13 | FEED_RSS = 'feeds/all.rss.xml'
14 | CATEGORY_FEED_RSS = 'feeds/%s.rss.xml'
15 |
16 | LINKS = (('Biologeek', 'http://biologeek.org'),
17 | ('Filyb', "http://filyb.info/"),
18 | ('Libert-fr', "http://www.libert-fr.com"),
19 | ('N1k0', "http://prendreuncafe.com/blog/"),
20 | (u'Tarek Ziadé', "http://ziade.org/blog"),
21 | ('Zubin Mithra', "http://zubin71.wordpress.com/"),)
22 |
23 | SOCIAL = (('twitter', 'http://twitter.com/ametaireau'),
24 | ('lastfm', 'http://lastfm.com/user/akounet'),
25 | ('github', 'http://github.com/ametaireau'),)
26 |
27 | # global metadata to all the contents
28 | DEFAULT_METADATA = (('yeah', 'it is'),)
29 |
30 | # static paths will be copied under the same name
31 | STATIC_PATHS = ["pictures",]
32 |
33 | # A list of files to copy from the source to the destination
34 | FILES_TO_COPY = (('extra/robots.txt', 'robots.txt'),)
35 |
36 | # foobar will not be used, because it's not in caps. All configuration keys
37 | # have to be in caps
38 | foobar = "barbaz"
39 |
--------------------------------------------------------------------------------
/.hgtags:
--------------------------------------------------------------------------------
1 | 7acafbf7e47b1287525026ad8b4f1efe443d5403 1.2
2 | 7acafbf7e47b1287525026ad8b4f1efe443d5403 1.2
3 | ae850ab0fd62a98a98da7ce74ac794319c6a5066 1.2
4 | 54a0309f79d6c5b54d8e1e3b5e3f744856b68a73 1.1
5 | 8f5e0eb037768351eb08840e588a4364266a69b3 1.1.1
6 | bb986ed591734ca469f726753cbc48ebbfce0dcc 1.2.1
7 | 8a3dad99cbfa6bb5d0ef073213d0d86e0b4c5dba 1.2.2
8 | 4a20105a242ab154f6202aa6651979bfbb4cf95e 1.2.3
9 | 803aa0976cca3dd737777c640722988b1f3769fe 1.2.4
10 | 703c4511105fd9c8b85afda951a294c194e7cf3e 1.2.5
11 | 6e46a40aaa850a979f5d09dd95d02791ec7ab0ef 2.0
12 | bf14d1a5c1fae9475447698f0f9b8d35c551f732 2.1
13 | da86343ebd543e5865050e47ecb0937755528d13 2.1.1
14 | 760187f048bb23979402f950ecb5d3c5493995b1 2.2
15 | 20aa16fe4daa3b70f6c063f170edc916b49837ed 2.3
16 | f9c1d94081504f21f5b2ba147a38099e45db1769 2.4
17 | e65199a0b2706d2fb48f7a3c015e869716e0bec1 2.4.1
18 | 89dbd7b6f114508eae62fc821326f4797dfc8b23 2.4.2
19 | 979b4473af56a191a278c83058bc9c8fa1fde30e 2.4.3
20 | 26a444fbb78becae358afa0a5b47587db8739b21 2.4.4
21 | 3542b65fd1963ae7065b6a3bc912fbb6c150e98c 2.4.5
22 | 87745dfdd51b96bf18eaaf6c402effa902c1b856 2.5.0
23 | 294a2830a393d5a97671dc211dbdb5254a15e604 2.5.1
24 | 294a2830a393d5a97671dc211dbdb5254a15e604 2.5.1
25 | 92b31e41134cb2c1a156ce623338cf634d2ebc3e 2.5.1
26 | 7d728f8e771cbbc802ce81e424e08a8eecbd48dc 2.5.2
27 | 7d728f8e771cbbc802ce81e424e08a8eecbd48dc 2.5.2
28 | 6d368a1739a4ce48d2d04b00db04fa538e2bf90a 2.5.2
29 | 1f9dd44b546425216b1fa35fd88d3d532da8916b 2.5.3
30 |
--------------------------------------------------------------------------------
/docs/contribute.rst:
--------------------------------------------------------------------------------
1 | How to contribute ?
2 | ###################
3 | There are many ways to contribute to pelican. You can enhance the
4 | documentation, add missing features, fix bugs or just report them.
5 |
6 | Don't hesitate to fork and make a pull request on github.
7 |
8 | Set up the development environment
9 | ==================================
10 |
11 | You're free to setup up the environment in any way you like. Here is a way
12 | using virtualenv and virtualenvwrapper. If you don't have them, you can install
13 | them using::
14 |
15 | $ pip install virtualenvwrapper
16 |
17 | Virtual environments allow you to work on an installation of python which is
18 | not the one installed on your system. Especially, it will install the different
19 | projects under a different location.
20 |
21 | To create the virtualenv environment, you have to do::
22 |
23 | $ mkvirtualenv pelican --no-site-package
24 |
25 | Then you would have to install all the dependencies::
26 |
27 | $ pip install -r dev_requirements.txt
28 |
29 | Running the test suite
30 | ======================
31 |
32 | Each time you add a feature, there are two things to do regarding tests:
33 | checking that the tests run in a right way, and be sure that you add tests for
34 | the feature you are working on or the bug you're fixing.
35 |
36 | The tests leaves under "pelican/tests" and you can run them using the
37 | "discover" feature of unittest2::
38 |
39 | $ unit2 discover
40 |
--------------------------------------------------------------------------------
/pelican/rstdirectives.py:
--------------------------------------------------------------------------------
1 | # -*- coding: utf-8 -*-
2 | from docutils import nodes
3 | from docutils.parsers.rst import directives, Directive
4 | from pygments.formatters import HtmlFormatter
5 | from pygments import highlight
6 | from pygments.lexers import get_lexer_by_name, TextLexer
7 |
8 | INLINESTYLES = False
9 | DEFAULT = HtmlFormatter(noclasses=INLINESTYLES)
10 | VARIANTS = {
11 | 'linenos': HtmlFormatter(noclasses=INLINESTYLES, linenos=True),
12 | }
13 |
14 |
15 | class Pygments(Directive):
16 | """ Source code syntax hightlighting.
17 | """
18 | required_arguments = 1
19 | optional_arguments = 0
20 | final_argument_whitespace = True
21 | option_spec = dict([(key, directives.flag) for key in VARIANTS])
22 | has_content = True
23 |
24 | def run(self):
25 | self.assert_has_content()
26 | try:
27 | lexer = get_lexer_by_name(self.arguments[0])
28 | except ValueError:
29 | # no lexer found - use the text one instead of an exception
30 | lexer = TextLexer()
31 | # take an arbitrary option if more than one is given
32 | formatter = self.options and VARIANTS[self.options.keys()[0]] \
33 | or DEFAULT
34 | parsed = highlight(u'\n'.join(self.content), lexer, formatter)
35 | return [nodes.raw('', parsed, format='html')]
36 |
37 | directives.register_directive('code-block', Pygments)
38 | directives.register_directive('sourcecode', Pygments)
39 |
--------------------------------------------------------------------------------
/docs/faq.rst:
--------------------------------------------------------------------------------
1 | Frequently Asked Questions (FAQ)
2 | ################################
3 |
4 | Here is a summary of the frequently asked questions for pelican.
5 |
6 | Is it mandatory to have a configuration file ?
7 | ==============================================
8 |
9 | No, it's not. Configurations files are just an easy way to configure pelican.
10 | For the basic operations, it's possible to specify options while invoking
11 | pelican with the command line (see `pelican --help` for more informations about
12 | that)
13 |
14 | I'm creating my own theme, how to use pygments ?
15 | ================================================
16 |
17 | Pygment add some classes to the generated content, so the theming of your theme
18 | will be done thanks to a css file. You can have a look to the one proposed by
19 | default `on the project website 
5 | {% else %}
6 | 
7 | {% endif %}
8 | 
Comments !
16 | 17 | 25 |