joak
/
varia.website
forked from varia/varia.website
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Varia's website
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
146 Commits
5 Branches
0 Tags
338 MiB
 
 
 
 
 
 
Tree: 4b413f5b33
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '4b413f5b33'
${ noResults }
varia.website/plugins/permalinks
mb@mb 04c2824180
adding the 2 submodules again 		7 years ago
..
README.md adding the 2 submodules again 7 years ago
__init__.py adding the 2 submodules again 7 years ago
permalinks.py adding the 2 submodules again 7 years ago

README.md

permalink

This plugin enables a kind of permalink which can be used to refer to a piece of content which is resistant to the file being moved or renamed.

It does this by creating additional output html in PERMALINK_PATH (default permalinks/) which include redirect code to point user at original page.

To work each page has to have an additional piece of metadata with the key permalink_id (configurable with PERMALINK_ID_METADATA_KEY which should remain static even through renames and should also be unique on the site.

This can be generated automatically with the filetime_from_git module and the GIT_FILETIME_GENERATE_PERMALINK option. This should always be used with GIT_FILETIME_FOLLOW to ensure this persists across renames.

Hacky redirects

To make this work with things like github.io I'm forced to use HTML and Javascript redirects rather than HTTP redirects which is obviously suboptimal.