shared_lib.txt file containing makrdown or HTML syntax of a global shared lib is not rendered

[Charles Moulliard]

Hi,

A shared_lib.txt file containing markdown or HTML syntax of a global shared lib is not rendered  when I click on the sidecar link - http://localhost:8080/job/<shared-mytools>/pipeline-syntax/globals

Test file : https://github.com/ch007m/jenkins-shared-lib/blob/main/vars/buildJavaApp.txt

See image rendered: https://www.dropbox.com/s/czf6patx3068iud/Screenshot%202021-01-08%20at%2011.55.13.png?dl=0

Do we have to configure a parameter on jenkins to render shared lib txt file to HTML or Markdown ?

Cheers

Charles

[Charles Moulliard]

This is not documented but it is needed then to do a few things:

- Install the markdown-plugin, restart jenkins

- Under "configureSecurity" of jenkins, select as Markup Formatter from the popuplist "Markdown" instead of "Plain text"

- Launch again the job importing the shared lib

- Open now the page containing the generated doc of your job : http://localhost:8080/job/<JOB_NAME>/pipeline-syntax/globals

Remark: Can a contributor/committer update please the content of the page https://www.jenkins.io/doc/book/pipeline/shared-libraries/#directory-structure ?