Readme.rst 9.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208
  1. Pelican Plugins
  2. ###############
  3. Beginning with version 3.0, Pelican supports plugins. Plugins are a way to add
  4. features to Pelican without having to directly modify the Pelican core. Starting
  5. with 3.2, all plugins (including the ones previously in the core) are
  6. moved here, so this is the central place for all plugins.
  7. How to use plugins
  8. ==================
  9. Easiest way to install and use these plugins is cloning this repo::
  10. git clone --recursive https://github.com/getpelican/pelican-plugins
  11. and activating the ones you want in your settings file::
  12. PLUGIN_PATHS = ['path/to/pelican-plugins']
  13. PLUGINS = ['assets', 'sitemap', 'gravatar']
  14. ``PLUGIN_PATHS`` can be a path relative to your settings file or an absolute path.
  15. Alternatively, if plugins are in an importable path, you can omit ``PLUGIN_PATHS``
  16. and list them::
  17. PLUGINS = ['assets', 'sitemap', 'gravatar']
  18. or you can ``import`` the plugin directly and give that::
  19. import my_plugin
  20. PLUGINS = [my_plugin, 'assets']
  21. Plugin descriptions
  22. ===================
  23. ======================== ===========================================================
  24. Plugin Description
  25. ======================== ===========================================================
  26. Always modified Copy created date metadata into modified date for easy "latest updates" indexes
  27. AsciiDoc reader Use AsciiDoc to write your posts.
  28. Asset management Use the Webassets module to manage assets such as CSS and JS files.
  29. Auto Pages Generate custom content for generated Author, Category, and Tag pages (e.g. author biography)
  30. Better code samples Wraps all `table` blocks with a class attribute `.codehilitetable` in an additional `div` of class `.hilitewrapper`. It thus permits to style codeblocks better, especially to make them scrollable.
  31. Better figures/samples Adds a `style="width: ???px; height: auto;"` attribute to any `<img>` tags in the content
  32. bootstrapify Automatically add bootstraps default classes to your content, usefull for md generated tables
  33. CJK auto spacing Inserts spaces between Chinese/Japanese/Korean characters and English words
  34. Clean summary Cleans your summary of excess images
  35. Code include Includes Pygments highlighted code in reStructuredText
  36. Collate content Makes categories of content available to the template as lists through a `collations` attribute
  37. Creole reader Allows you to write your posts using the wikicreole syntax
  38. Custom article URLs Adds support for defining different default URLs for different categories
  39. Disqus static comments Adds a disqus_comments property to all articles. Comments are fetched at generation time using disqus API
  40. Encrypt content Password protect pages and articles
  41. Extract table of content Extracts table of contents (ToC) from `article.content`
  42. Feed Summary Allows article summaries to be used in ATOM and RSS feeds instead of the entire article
  43. Filetime from git Uses git commit to determine page date
  44. Figure References Provides a system to number and references figures
  45. Gallery Allows an article to contain an album of pictures
  46. Gist directive This plugin adds a ``gist`` reStructuredText directive.
  47. GitHub activity On the template side, you just have to iterate over the ``github_activity`` variable
  48. Global license Allows you to define a ``LICENSE`` setting and adds the contents of that license variable to the article's context
  49. Goodreads activity Lists books from your Goodreads shelves
  50. GooglePlus comments Adds GooglePlus comments to Pelican
  51. Gravatar Assigns the ``author_gravatar`` variable to the Gravatar URL and makes the variable available within the article's context
  52. Gzip cache Enables certain web servers (e.g., Nginx) to use a static cache of gzip-compressed files to prevent the server from compressing files during an HTTP call
  53. Headerid This plugin adds an anchor to each heading so you can deeplink to headers in reStructuredText articles.
  54. HTML entities Allows you to enter HTML entities such as &copy;, &lt;, &#149; inline in a RST document
  55. HTML tags for rST Allows you to use HTML tags from within reST documents
  56. I18N Sub-sites Extends the translations functionality by creating internationalized sub-sites for the default site
  57. ical Looks for and parses an ``.ics`` file if it is defined in a given page's ``calendar`` metadata.
  58. Image Process Automates the processing of images based on their class attributes
  59. Interlinks Lets you add frequently used URLs to your markup using short keywords
  60. Libravatar Allows inclusion of user profile pictures from libravatar.org
  61. Liquid-style tags Allows liquid-style tags to be inserted into markdown within Pelican documents
  62. Load CSV Adds ``csv`` Jinja tag to display the contents of a CSV file as an HTML table
  63. Multi parts posts Allows you to write multi-part posts
  64. Markdown Inline Extend Enables you to add customize inline patterns to your markdown
  65. Neighbor articles Adds ``next_article`` (newer) and ``prev_article`` (older) variables to the article's context
  66. Open graph Generates Open Graph tags for your articles
  67. Optimize images Applies lossless compression on JPEG and PNG images
  68. PDF generator Automatically exports RST articles and pages as PDF files
  69. PDF Images If an img tag contains a PDF, EPS or PS file as a source, this plugin generates a PNG preview which will then act as a link to the original file.
  70. Pelican-flickr Brings your Flickr photos & sets into your static website
  71. pelican_javascript Allows you to embed Javascript and CSS files into individual articles
  72. pelican-toc Generates a Table of Contents and make it available to the theme via article.toc
  73. Pelican Cite Produces inline citations and a bibliography in articles and pages, using a BibTeX file.
  74. Pelican Gist tag Easily embed GitHub Gists in your Pelican articles
  75. Pelican Page Order Adds a ``page_order`` attribute to all pages if one is not defined.
  76. Pelican comment system Allows you to add static comments to your articles
  77. Pelican Vimeo Enables you to embed Vimeo videos in your pages and articles
  78. Pelican YouTube Enables you to embed YouTube videos in your pages and articles
  79. pelicanfly Lets you type things like `i ♥ :fa-coffee:` in your Markdown documents and have it come out as little Font Awesome icons in the browser
  80. Pin to top Pin Pelican's article(s) to top "Sticky article"
  81. PlantUML Allows you to define UML diagrams directly into rst documents using the great PlantUML tool
  82. Post statistics Calculates various statistics about a post and store them in an article.stats dictionary
  83. Random article Generates a html file which redirect to a random article
  84. Read More link Inserts an inline "read more" or "continue" link into the last html element of the object summary
  85. Related posts Adds the ``related_posts`` variable to the article's context
  86. Markdown-metaYAML Pelican reader to enable YAML-style metadata in markdown articles
  87. Math Render Gives pelican the ability to render mathematics
  88. Panorama Creates charts from posts metadata
  89. Replacer Replace a text of a generated HTML
  90. Representative image Extracts a representative image (i.e, featured image) from the article's summary or content
  91. RMD Reader Create posts via knitr RMarkdown files
  92. Share post Creates share URLs of article
  93. Simple footnotes Adds footnotes to blog posts
  94. Sitemap Generates plain-text or XML sitemaps
  95. Slim Render theme template files via Plim, a Python port of Slim, instead of Jinja
  96. Static comments Allows you to add static comments to an article
  97. Subcategory Adds support for subcategories
  98. Summary Allows easy, variable length summaries directly embedded into the body of your articles
  99. tag_cloud Provides a tag_cloud
  100. Thumbnailer Creates thumbnails for all of the images found under a specific directory
  101. Tipue Search Serializes generated HTML to JSON that can be used by jQuery plugin - Tipue Search
  102. Touch Does a touch on your generated files using the date metadata from the content
  103. Twitter Bootstrap Defines some rst directive that enable a clean usage of the twitter bootstrap CSS and Javascript components
  104. W3C validate Submits generated HTML content to the W3C Markup Validation Service
  105. ======================== ===========================================================
  106. Please refer to the ``Readme`` file in a plugin's folder for detailed information about
  107. that plugin.
  108. Contributing a plugin
  109. =====================
  110. Please refer to the `Contributing`_ file.
  111. .. _Contributing: Contributing.rst