User Tools

Site Tools


dev-guide:markdowndoku

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
dev-guide:markdowndoku [2024/07/05 17:07] – [Create embedded documentation based on markdown files] gaetandev-guide:markdowndoku [2024/07/08 10:50] (current) timOb
Line 7: Line 7:
  
 To use this pipeline it is required that pandoc is installed, and that the project contains the files To use this pipeline it is required that pandoc is installed, and that the project contains the files
-template.docbook and copyfilter.lua in the directory src/main/resources/doc. Both files can be found in the [[https://gitlab.com/grogra/groimp-template/newplugin-maven|maven template]].+template.docbook and copyfilter.lua in the directory ''src/main/resources/doc''. Both files can be found in the [[https://gitlab.com/grogra/groimp-template/newplugin-maven|maven template]].
  
  
Line 27: Line 27:
 ===== Selecting a source ===== ===== Selecting a source =====
  
-The source of the pipeline is by default "README.md" (caution its case sensitive), if the source is suppose to be any different file it can be defined in the "MarkdownDocFile" option:+The source of the pipeline is by default "README.md" (caution it is case sensitive), if the source is suppose to be any different file it can be defined in the "MarkdownDocFile" option:
  
 <code xml> <code xml>
Line 80: Line 80:
  
 </code> </code>
 +
 +
 +==== Defining the title ====
 +
 +By default the title of the chapter of documentation is the name of the plugin in the maven pom. 
 +This name can be change by adding the variable "ftitle" to the first markdown file:
 +
 +<code>
 +---
 +ftitle: GroIMP user manual
 +...
 +
 +</code>
 +
  
dev-guide/markdowndoku.1720192029.txt.gz · Last modified: 2024/07/05 17:07 by gaetan