Pelican plugin to improve SEO (Search Engine Optimization) to reach top positions on search engines.
Project description
SEO Plugin for Pelican 🇫🇷
This plugin helps you improve your Pelican site SEO (Search Engine Optimization) to reach the top positions on search engines. To see what this SEO plugin can do for you, visit the Usage section.
| Author | GitHub |
|---|---|
| Maëva Brunelles | https://github.com/MaevaBrunelles |
Why Use This Plugin?
If:
- you are not familiar with SEO
- you want an easy way to apply SEO fundamentals
- you need help improving the SEO of your Pelican site
… then this plugin is for you!
SEO comes with two features to help you:
- SEO Report — Generates an HTML report based on article analysis, indicating what is good, what could be improved, and what is problematic. Useful if you want to improve the ranking of your articles.
- SEO Enhancer — Generates robot indexing guidelines, HTML tags, and structured data. Useful if you want to control how your site appears in search engine results.
Installation
This plugin can be installed via:
python -m pip install pelican-seo
Requirements
The above installation step should automatically install Beautiful Soup 4, which the SEO plugin requires. The following command will manually install this dependency:
python -m pip install beautifulsoup4
Please keep in mind that the SITEURL Pelican setting must be defined in order for this plugin to function as intended.
Usage
You can enable/disable features by setting them to True or False in your Pelican settings. The default is True for both.
# settings.py
SEO_REPORT = True # To enable this feature
SEO_ENHANCER = False # To disable this feature
The SEO plugin runs when you generate your site. If you want to see SEO logging in your console output, add the --verbose option to your pelican invocation:
$ pelican content --verbose
-> SEO plugin initialized
-> SEO plugin - SEO Report: seo_report.html file created
-> SEO plugin - SEO Enhancement: robots.txt file created
-> Writing /output/my-first-review.html
-> SEO plugin - SEO Enhancement: Done for /output/my-first-review.html
Done: Processed 1 articles, 0 drafts, 0 pages, 0 hidden pages and 0 draft pages in 0.17 seconds.
SEO Report
The SEO plugin analyzes all your articles and pages and generate an SEO HTML report in your Pelican project root: seo-report.html
Example:
You can set limits for article and page analysis in the plugin settings.py. By default, it's set up to 10 articles and 10 pages.
SEO_ARTICLES_LIMIT = 10
SEO_PAGES_LIMIT = 10
The SEO analysis begins with the most recent articles/pages, according to the date metadata, and is focused on the following criteria:
- Page title:
<title></title> - Page description:
<meta name="description" content="" /> - Heading content:
<h1></h1> - Internal site links:
<a href="SITEURL/..."></a>
The above information is defined in your source content, such as the following example Markdown file:
Title: Page Title
Description: Page Description
# Heading Content
[Internal link](https://example.com/about.html)
Once the SEO analysis has generated a report, optimize your articles and pages according to the report’s recommendations, and then repeat the analysis to see whether everything comes up green.
SEO Enhancer
The SEO Enhancer module generates the following for you:
- robots file
- HTML enhancements
- structured data
Robots.txt File
The generated robots.txt file indicates to search engines which pages they should index. By default, search engine bots are allowed to crawl and index all pages.
User-agent: *
To disallow crawling and/or forbid indexing for a given article/page, add the following to your article/page metadata:
Disallow: True
Noindex: True
A robots.txt file will be generated at your web site root, as per the OUTPUT_PATH setting (Pelican’s default is output/).
# robots.txt
User-agent: *
Disallow: example.html
Noindex: other-example.html
Canonical URL Tag
The SEO Enhancer automatically adds canonical link metadata to <head> tags in order to avoid presenting duplicate content to search engines.
<link rel="canonical" href="<SITEURL>/example.html" />
Structured Data
The SEO Enhancer automatically adds structured data in the <head> tag in order to improve the display of result snippets in search engines. Articles will have both article schema and breadcrumb schema, while pages will only have breadcrumb schema.
Structured data is based on Schema.org vocabulary, with JSON-LD encoding. Note that schemas generated by default are compliant with Schema.org but not (by default) Google-compliant. The latter requires additional metadata.
Breadcrumb Schema
Based on BreadcrumbList schema:
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": :n=1:,
"name": :Sitename:,
"item": :SITEURL:
},
{
"@type": "ListItem",
"position": :n+1:,
"name": :name:,
"item": :url:
},
{
"@type": "ListItem",
"position": :n+x:,
"name": :name:,
"item": :url:
}
]
}
Each path element has a ListItem, even folders, so it’s better to create a user-friendly page for those (otherwise you’ll get your server’s default page).
Article schema
Based on Article schema:
{
"@context": "https://schema.org",
"@type": "Article",
"author": {
"@type": "Person",
"name": :author:
},
"publisher": {
"@type": "Organization",
"name": :sitename:,
"logo": {
"@type": "ImageObject",
"url": :logo:
}
},
"headline": :title:,
"about": :category:,
"datePublished": :publication_date:,
"image": :image:
}
:logo: and :image: fields are not required by Schema.org but are by Google.
To populate the :logo: field, add a LOGO setting to your Pelican settings file containing an absolute link to your site logo image:
# pelicanconf.py
LOGO = "https://www.example.com/logo.jpg"
To populate the :image: field, add an image metadata field to your Markdown/reST content:
# article.md
Image: https://www.example.com/article-image.jpg
# article.rst
:image: https://www.example.com/article-image.jpg
Contributing
Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on existing issues.
To start contributing to this plugin, review the Contributing to Pelican documentation, beginning with the Contributing Code section.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pelican_seo-1.0.2-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b18a3371288a2cec33a1c896137c2e684fb3abf04d8d724f6443c8059365a840 |
|
| MD5 | d5f3e265bde72f7fd7157ee6da49e3c5 |
|
| BLAKE2b-256 | a20e03705108deea532ca034b5cb1535439d66fdbe3a0d28438e27097ec4a431 |
