[feat]: Support for global bibliographies #270
Draft
+549
−366
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Hello @shyamd!
One feature that would be very useful for my work would be a global and latex-like bibliography. While thinking about this feature, I noted the following:
\full_bibliography
tag is located in the documentation.I gave this project a try and ended up doing a pretty extensive rewrite of the plugin ...
I tried to fix the first issue by pre-parsing the files of the documentation in the
on_file
mkdocs callback.The second issue is handled by introducing different citation formats (
footnote
,inline
,link
).The last issue is fixed by having global or per-page bibliography indexes depending on the setting chosen by the user.
I have also changed some of the configuration options of the plugin.
The default behavior results in the same output as today:
A global bibliography would be configured this way:
Even though there are quite a lot of changes that should still be made before this can be merged, it is in a mostly functional state. I was curious if you would be interested in taking over some of these changes in the official plugin.
I have not yet updated any of the tests, documentation, etc.