mkdocs: Improve site part2

[datamweb]

Description

https://datamweb.github.io/shield

See https://github.com/timvink/mkdocs-git-revision-date-localized-plugin
You need pip3 install mkdocs-git-revision-date-localized-plugin.

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[datamweb]

@kenjis has a warning due to the use of dotenv. It seems that the solution is not to use dotenv or write a plugin for highlight or use class nohighlight. Not sure how to fix it now. We continue with the same conditions.

WARN: Could not find the language 'dotenv', did you forget to load/include a language module?

[kenjis]

What do you mean?

[datamweb]

@kenjis see:

[kenjis]

It seems ```dotenv is not supported by highlight.js.

[datamweb]

Yes, exactly, the solution is to write a plugin(like what was done for curl) or reject an interpreter with class nohighlight.

[kenjis]

How about removing dotenv in the markdown?

[datamweb]

By removing dotenv, language it will be set to ini. This is not correct.

But we will use it temporarily. what do you think?

[kenjis]

Change to ```text.
ini is not correct, because it is not a ini file.

[kenjis]

I sent PR #864

Cannot run mkdocs

[kenjis]

@datamweb How can I run mkdocs?

$ mkdocs serve
ERROR   -  Config value 'theme': Unrecognised theme name: 'material'. The available installed themes are: mkdocs, readthedocs
ERROR   -  Config value 'markdown_extensions': Failed to load extension 'pymdownx.superfences'.
           ModuleNotFoundError: No module named 'pymdownx'

Aborted with 2 configuration errors!

[kenjis]

Resolved.

$ pip3 install mkdocs
$ pip3 install mkdocs-material
$ pip3 install mkdocs-git-revision-date-localized-plugin

[kenjis]

LGTM!