credits page

[rachmadaniHaryono]

resolves #22

• template is based on pawamoy jinja template with table format from https://axgkl.github.io/docutools/about/credits/
• this may require minimum pip version to fix the linked issue

[pawamoy]

Nice, thanks! Just a few quality things to fix (see CI)

[rachmadaniHaryono]

i think i misunderstand jinja and copier.
i thought file with jinja suffix on docs folder will generate new file when run make docs or make docs-serve

[pawamoy]

So, credits must be generated each time we build the docs (because dependencies can change regularly).
Without specific plugins, Markdown pages are not rendered through Jinja by MkDocs. That's what the macros plugin does.
But in our case, the credits template needs specific context, that MkDocs itself (or even macros) is not aware of.
That is why we used macros to "inject" the get_credits function into the global context, function that returns the contents of credits.

You tried to use a shortcut: that's a nice idea. But in your changes macros is injecting get_credits_data, while the credits template is trying to access the return value of get_credits_data. Maybe you could add a {% set data = get_credits_data() %} at the top of the template, and then prefix each Jinja variable with data..

Or you could refactor to use the same logic as in the copier-pdm template, i.e. stop using macros and replace it with mkdocs-gen-files.

[rachmadaniHaryono]

Maybe you could add a {% set data = get_credits_data() %} at the top of the template, and then prefix each Jinja variable with data..

i think i will choose this one