feat: Support configurable display of version

[Roiocam]

Refs: apache/pekko-site#33

Then we can hidden page versioning on "top-level-page" of Pekko website, and still display by default for other project, all those stuff can switch via configuration.

usage

set it by specifying the flag in build.sbt

paradoxProperties += ("disabled.versioning.display" -> "true")

example

[pjfanning]

We use this plugin for all our docs. It is only on 1 repo where we want to remove the version (https://github.com/apache/incubator-pekko-site). Could we change this so the version display is configurable (on by default - but possible to use a config to disable it)?

[pjfanning]

as an fyi, there has been discussion about not using paradox and this plugin for generating the top level pages in https://github.com/apache/incubator-pekko-site - switching to using another tool that is more suited for the static content that we want on these top level pages

fyi @mdedetrich

[mdedetrich]

Am I missing something or is there supposed to be paradoxProperties += ("disabled.versioning.display" -> "true") somewhere in the code, it seems you have only committed the resulting rendered site and forgot the actual config?

[mdedetrich]

as an fyi, there has been discussion about not using paradox and this plugin for generating the top level pages in https://github.com/apache/incubator-pekko-site - switching to using another tool that is more suited for the static content that we want on these top level pages

fyi @mdedetrich

I still have this sentiment but I am not going to block changes like this over it

[Roiocam]

Am I missing something or is there supposed to be paradoxProperties += ("disabled.versioning.display" -> "true") somewhere in the code, it seems you have only committed the resulting rendered site and forgot the actual config?

@mdedetrich No, you are not missing anything. This PR using paradox boolean expression which selective display the versioning via config.

$ if (!page.property_is.("disabled.versioning.display").("true")) $

No config change because it enable display by default, And it will only be hidden in explicit configuration (such as repo pekko-site need to do)

An additional pull request is required for the pekko-site repo.

[mdedetrich]

nvm I was being daft, lgtm

[pjfanning]

looks like it should work - I plan to test this on my laptop later (uptake in pekko-site repo) and can merge it if that test goes ok

[Roiocam]

looks like it should work - I plan to test this on my laptop later (uptake in pekko-site repo) and can merge it if that test goes ok

@pjfanning Thank you for testing. When the KV is not matching ("disabled.versioning.display" -> "true"), the hiding should also not work.

[pjfanning]

lgtm