Generate sitemaps from configuration
Project description
SitemapCfg
Django's sitemap framework is classic Django. It covers all Django functionality. It's class-based. It's configurable and flexible. It can reverse URLs and ping Google. Most of the time it's exactly what you want, and everything you could want. But not all of the time. Perhaps, like me, you use Django in an unusual way. The sitemap framework is not only difficult to use, it will not do some things I want. So I've made this configuration-based alternative. It's crude, but simple.
Why you would not want to use this app
- Can only output URLs from model URL data, not views
- Has no exclude/filter configuration, outputs everything
- No checks for file-size, subfolder renaming etc.
- Creates an index always, despite one sitemap only
- Ignores most of the sitemap spec
- Can only handle one site
Why you would want to use this app
- Search engines also ignore most of the spec
- 5 minuite setup in 'settings' file only
Documentation
Install
PyPi,
pip install django-sitemapcfg
Or download the app code to Django.
The module needs no database tables, but need to declare so the registered module can find models etc. Declare in Django settings,
INSTALLED_APPS = [
...
'sitemap_cfg.apps.SitemapCfgConfig',
]
Configuration
Need to declare where the sitemap files will go,
SITEMAP_DIR = PROJECT_DIR / "static"
The domain (usually aiming for cannonical),
SITEMAP_DOMAIN = "https://freefalling.com"
Then declare which models to use, or URLs to add. Keys are the sitemap filename,
SITEMAP = {
# Model names are just the app/model name (not the full path)
# If model is the only data given, tries to use get_absolute_url()
'sitemap_reviews' : [
{'model': 'reviews.Review'},
],
# Can have different collections of data in one sitemap
# can use field and path data. Both keys must be present
'sitemap_netfeatures' : [
{'model': 'reviews.SongReview'},
{'model': 'datelists.Itineries'},
],
# Can use data from the model to construct URLs, usually a slug
'sitemap_infopages' : [
{'model': 'infopages.Infopage', 'field' : 'slug', 'url_path': 'info'},
],
# can also declare one-off URLs.
# if preceeded by ''http' these are written as presented...
# if written as stubs get prepended by SITEMAP_DOMAIN
'sitemap_other' : [
{'urls': ['credits', '', 'https://freefalling.com/' ]},
],
}
Generate sitemaps
./manage.py mksitemap
End of...
Said it was simple.
Project details
Release history Release notifications | RSS feed
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 sitemap_cfg-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fa1199125a12baa41c879ab8c9b2392056c66354834ee26ef35a15c079a248f2 |
|
MD5 | 3d838cb39b5f34cfbdbef7717f20a021 |
|
BLAKE2b-256 | bf3f1c859aab17905dbe3074afa8a36bba9785b1dcf463770ef9efe12ffbeec7 |