diff --git a/.gitignore b/.gitignore index 61110f2d..5dc5945e 100644 --- a/.gitignore +++ b/.gitignore @@ -21,6 +21,7 @@ target/ .vscode/ .vs/ _exported_templates/ +tools/ ############### # temp file # diff --git a/README.md b/README.md index d890e1a5..4707fc39 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,21 @@ # fiskaltrust interface documentation +_Welcome to the open source documentation of the fiskaltrust interface!_ -Welcome to the open source documentation of fiskaltrust interface. Please review this README file to understand how you can assist in contributing to the fiskaltrust interface documentation. +The technical specification of the data interface described in this document provides information regarding the following areas: +1. Access to the fiskaltrust.Service +2. Integration into the receipt based cash register workflow +3. The data structure +4. Function structure of the interface +5. Types of communication with fiskaltrust.Service +6. Operating categories +Interface specification is provided by fiskaltrust.Interface nuget package, which can be found at https://www.nuget.org/packages/fiskaltrust.interface -## Repository structure +Official PDF documents that are built from the source in this repository can be found on the [Releases page](https://github.com/fiskaltrust/interface-doc/releases). +## Contributions +If you want to contribute to this documentation, please review this README file to understand how it is structured and which tools are used. + +### Repository structure All documentation files are stored within the `/doc` folder in this repository (markdown, images, other static content). - One sub-directory and one or more markdown file(s) per chapter should be created (e.g. `general/general.md`.) @@ -12,21 +24,18 @@ All documentation files are stored within the `/doc` folder in this repository ( - You may also use multiple files per chapter, but keep in mind that a page-break is created by DocFx after every markdown file. - Images must be stored within a folder called `images`. Multiple image folders in different sub-directories are supported, DocFx just scans for the directory name. -## Tools - -### DocFx +### Tools +#### DocFx [DocFx](https://dotnet.github.io/docfx) is a documentation generation tool that creates HTML and PDF documentation from markdown files. It's e.g. be used by Microsoft to generate docs.microsoft.com. Use either chocolatey or nuget.exe to install DocFx, as described [here](https://github.com/docascode/docfx-seed/blob/master/README.md). -### wkhtmltopdf - +#### wkhtmltopdf [wkhtmltopdf](https://wkhtmltopdf.org/) is used internally by DocFx to convert HTML files to PDF. Download and install it from the website linked above. > Please note that wkhtmltopdf 0.12.5 has a bug that prevents the creation of TOCs. Use either the previous (0.12.4) or any newer version. -### PlantUML - +#### PlantUML - This documentation supports the PlantUML notation, which will be converted to SVG images and embedded into the PDF during the build. - Please add the `skinparam shadowing false` to your diagram. wkhtmltopdf has currently some issues with the transparency caused by the shading. - The notation for a PlantUML section in the markdown files changed with the new tooling. @@ -39,3 +48,10 @@ skinparam shadowing false Diagram ``` ```` + +### Release +To create a release, clone the repository locally and run the following commands: +```console +git tag +git push origin --tags +``` \ No newline at end of file diff --git a/azure-pipelines.yml b/azure-pipelines.yml index f02c7acb..f538dd18 100644 --- a/azure-pipelines.yml +++ b/azure-pipelines.yml @@ -53,6 +53,10 @@ steps: nuget install DocFx.Plugins.PlantUml -ExcludeVersion -OutputDirectory . displayName: 'Install prerequisites' +- task: PowerShell@2 + inputs: + filePath: 'set-chapter-numbers.ps1' + - powershell: | Start-Process docfx -Wait -RedirectStandardError $(Build.ArtifactStagingDirectory)/docfx-err.log -RedirectStandardOutput $(Build.ArtifactStagingDirectory)/docfx-out.log displayName: Run docfx diff --git a/cover.html b/cover.html index d3ec3b75..1ac2625d 100644 --- a/cover.html +++ b/cover.html @@ -4,7 +4,7 @@ diff --git a/doc/images/fiskaltrust.png b/doc/images/fiskaltrust.png index 86cd355c..44e7403a 100644 Binary files a/doc/images/fiskaltrust.png and b/doc/images/fiskaltrust.png differ diff --git a/docfx.json b/docfx.json index d81e3ae3..effb8f24 100644 --- a/docfx.json +++ b/docfx.json @@ -20,7 +20,7 @@ "pdf": { "keepRawFiles": true, "wkhtmltopdf": { - "additionalArguments": "--footer-center [page] --margin-top 25 --margin-bottom 25 --margin-left 30 --margin-right 30 cover cover.html toc --xsl-style-sheet style.xsl" + "additionalArguments": "--dpi 200 --zoom 0.78 --footer-center [page] --margin-top 25 --margin-bottom 25 --margin-left 30 --margin-right 30 cover cover.html toc --xsl-style-sheet style.xsl" }, "content": [ { diff --git a/set-chapter-numbers.ps1 b/set-chapter-numbers.ps1 new file mode 100644 index 00000000..37b8eeb9 --- /dev/null +++ b/set-chapter-numbers.ps1 @@ -0,0 +1,7 @@ +# Get chapter numbering tool from GitHub +New-Item -Name "tools" -ItemType Directory -Force +Invoke-WebRequest -Uri https://github.com/TSchmiedlechner/DocFxChapterNumbers/releases/download/v1.0.2/DocFxChapterNumbers-v1.0.2.zip -OutFile "./tools/DocFxChapterNumbers.zip" +Expand-Archive "./tools/DocFxChapterNumbers.zip" -DestinationPath "./tools/DocFxChapterNumbers" -Force + +Rename-Item ./doc ./doc_prev +./tools/DocFxChapterNumbers/DocFxChapterNumbers.exe ./doc_prev/toc.md ./doc --force \ No newline at end of file diff --git a/style.xsl b/style.xsl index 89dad75d..14e5ebe2 100644 --- a/style.xsl +++ b/style.xsl @@ -10,7 +10,7 @@ h1 { text-align: center; font-size: 20px; - font-family: arial; + font-family: "Trebuchet MS" !important; } div {border-bottom: 1px dashed rgb(200,200,200); } @@ -18,26 +18,14 @@ li {list-style: none; margin: 5px 0;} ul { - font-size: 20px; - font-family: arial; + font-size: 18px; + font-family: "Trebuchet MS" !important; } ul ul {font-size: 100%; } ul {padding-left: 0em;} ul ul {padding-left: 1em;} a {text-decoration:none; color: black;} - - - body ul { - counter-reset: item; - } - - - li div a:before { - content: counters(item, ".") ". "; - counter-increment: item; - } - diff --git a/templates/fiskaltrust.pdf/styles/main.css b/templates/fiskaltrust.pdf/styles/main.css index cad39f58..768a8d80 100644 --- a/templates/fiskaltrust.pdf/styles/main.css +++ b/templates/fiskaltrust.pdf/styles/main.css @@ -2,19 +2,10 @@ display: none !important; } -body {counter-reset: h1} -h1 {counter-reset: h2} -h2 {counter-reset: h3} -h3 {counter-reset: h4} -h4 {counter-reset: h5} -h5 {counter-reset: h6} - -h1:before {counter-increment: h1; content: counter(h1) ". "} -h2:before {counter-increment: h2; content: counter(h1) "." counter(h2) ". "} -h3:before {counter-increment: h3; content: counter(h1) "." counter(h2) "." counter(h3) ". "} -h4:before {counter-increment: h4; content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) ". "} -h5:before {counter-increment: h5; content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) ". "} -h6:before {counter-increment: h6; content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) "." counter(h6) ". "} -h6:before {counter-increment: h6; content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) "." counter(h5) "." counter(h6) ". "} +body, h3, h4, h5, h6 { + font-family: "Trebuchet MS" !important; +} -h1.nocount:before, h2.nocount:before, h3.nocount:before, h4.nocount:before, h5.nocount:before, h6.nocount:before { content: ""; counter-increment: none } \ No newline at end of file +.hljs { + font-size: 1.5em !important; +}