Skip to content

Commit 651a32d

Browse files
dr0idr0i
committed
Merge #30 from branch '29-fixLocalBuild' of github.com:metafacture/metafacture.github.io into main
2 parents fc48cd2 + 1f798c3 commit 651a32d

12 files changed

+132
-572
lines changed

‎.github/workflows/generate_html.yml

+4-4
Original file line numberDiff line numberDiff line change
@@ -28,18 +28,18 @@ jobs:
2828
--standalone
2929
--title-prefix="Metafacture"
3030
getting-started.md
31-
- name: Generate ide-extensions/index.html
31+
- name: Generate ide-extensions.html
3232
uses: docker://pandoc/core:2.9
3333
with:
3434
args: >
35-
--output=ide-extensions/index.html
35+
--output=ide-extensions.html
3636
--include-before-body=navigation.html
3737
--css=../github-pandoc.css
3838
--standalone
3939
--title-prefix="Metafacture"
40-
ide-extensions/index.md
40+
ide-extensions.md
4141
- name: Commit html files
4242
uses: EndBug/add-and-commit@v5
4343
with:
4444
message: "Add newly generated html files by GitHub Actions."
45-
add: "index.html getting-started.html ide-extensions/index.html --force"
45+
add: "index.html getting-started.html ide-extensions/index.html --force"

‎README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ The HTML files are generated by Github Actions on every Push. If you want to tes
55
1. Install [pandoc](https://pandoc.org/installing.html)
66
2. Execute
77
```
8-
pandoc --output=index.html --include-before-body=navigation.html --css=github-pandoc.css --standalone --title-prefix "Metafacture" index.md
8+
pandoc --output=index.html --include-before-body=navigation.html --css=github-pandoc.css --standalone --title-prefix "Metafacture" index.md; pandoc --output=getting-started.html --include-before-body=navigation.html --css=github-pandoc.css --standalone --title-prefix "Metafacture" getting-started.md; pandoc --output=ide-extensions.html --include-before-body=navigation.html --css=github-pandoc.css --standalone --title-prefix "Metafacture" ide-extensions.md
99
```
10-
for generating the index.html on root.
10+
for generating index.html, getting-started.html and ide-extensions.html on root.
1111
1212
# Page Content
1313
## Main Page

‎ide-extensions/fix.vsix ‎fix.vsix

File renamed without changes.

‎ide-extensions/flux.vsix ‎flux.vsix

File renamed without changes.

‎getting-started.html

+81-85
Original file line numberDiff line numberDiff line change
@@ -5,105 +5,101 @@
55
<meta name="generator" content="pandoc" />
66
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
77
<title>Metafacture – Getting started</title>
8-
<style>
9-
code{white-space: pre-wrap;}
10-
span.smallcaps{font-variant: small-caps;}
11-
span.underline{text-decoration: underline;}
12-
div.column{display: inline-block; vertical-align: top; width: 50%;}
13-
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
14-
ul.task-list{list-style: none;}
15-
pre > code.sourceCode { white-space: pre; position: relative; }
16-
pre > code.sourceCode > span { display: inline-block; line-height: 1.25; }
17-
pre > code.sourceCode > span:empty { height: 1.2em; }
18-
code.sourceCode > span { color: inherit; text-decoration: inherit; }
19-
div.sourceCode { margin: 1em 0; }
20-
pre.sourceCode { margin: 0; }
21-
@media screen {
22-
div.sourceCode { overflow: auto; }
23-
}
24-
@media print {
25-
pre > code.sourceCode { white-space: pre-wrap; }
26-
pre > code.sourceCode > span { text-indent: -5em; padding-left: 5em; }
27-
}
28-
pre.numberSource code
29-
{ counter-reset: source-line 0; }
30-
pre.numberSource code > span
31-
{ position: relative; left: -4em; counter-increment: source-line; }
32-
pre.numberSource code > span > a:first-child::before
33-
{ content: counter(source-line);
34-
position: relative; left: -1em; text-align: right; vertical-align: baseline;
35-
border: none; display: inline-block;
36-
-webkit-touch-callout: none; -webkit-user-select: none;
37-
-khtml-user-select: none; -moz-user-select: none;
38-
-ms-user-select: none; user-select: none;
39-
padding: 0 4px; width: 4em;
40-
color: #aaaaaa;
41-
}
42-
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
43-
div.sourceCode
44-
{ }
45-
@media screen {
46-
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
47-
}
48-
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
49-
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
50-
code span.at { color: #7d9029; } /* Attribute */
51-
code span.bn { color: #40a070; } /* BaseN */
52-
code span.bu { } /* BuiltIn */
53-
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
54-
code span.ch { color: #4070a0; } /* Char */
55-
code span.cn { color: #880000; } /* Constant */
56-
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
57-
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
58-
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
59-
code span.dt { color: #902000; } /* DataType */
60-
code span.dv { color: #40a070; } /* DecVal */
61-
code span.er { color: #ff0000; font-weight: bold; } /* Error */
62-
code span.ex { } /* Extension */
63-
code span.fl { color: #40a070; } /* Float */
64-
code span.fu { color: #06287e; } /* Function */
65-
code span.im { } /* Import */
66-
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
67-
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
68-
code span.op { color: #666666; } /* Operator */
69-
code span.ot { color: #007020; } /* Other */
70-
code span.pp { color: #bc7a00; } /* Preprocessor */
71-
code span.sc { color: #4070a0; } /* SpecialChar */
72-
code span.ss { color: #bb6688; } /* SpecialString */
73-
code span.st { color: #4070a0; } /* String */
74-
code span.va { color: #19177c; } /* Variable */
75-
code span.vs { color: #4070a0; } /* VerbatimString */
76-
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
8+
<style type="text/css">
9+
code{white-space: pre-wrap;}
10+
span.smallcaps{font-variant: small-caps;}
11+
span.underline{text-decoration: underline;}
12+
div.column{display: inline-block; vertical-align: top; width: 50%;}
13+
</style>
14+
<style type="text/css">
15+
a.sourceLine { display: inline-block; line-height: 1.25; }
16+
a.sourceLine { pointer-events: none; color: inherit; text-decoration: inherit; }
17+
a.sourceLine:empty { height: 1.2em; }
18+
.sourceCode { overflow: visible; }
19+
code.sourceCode { white-space: pre; position: relative; }
20+
div.sourceCode { margin: 1em 0; }
21+
pre.sourceCode { margin: 0; }
22+
@media screen {
23+
div.sourceCode { overflow: auto; }
24+
}
25+
@media print {
26+
code.sourceCode { white-space: pre-wrap; }
27+
a.sourceLine { text-indent: -1em; padding-left: 1em; }
28+
}
29+
pre.numberSource a.sourceLine
30+
{ position: relative; left: -4em; }
31+
pre.numberSource a.sourceLine::before
32+
{ content: attr(title);
33+
position: relative; left: -1em; text-align: right; vertical-align: baseline;
34+
border: none; pointer-events: all; display: inline-block;
35+
-webkit-touch-callout: none; -webkit-user-select: none;
36+
-khtml-user-select: none; -moz-user-select: none;
37+
-ms-user-select: none; user-select: none;
38+
padding: 0 4px; width: 4em;
39+
color: #aaaaaa;
40+
}
41+
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
42+
div.sourceCode
43+
{ }
44+
@media screen {
45+
a.sourceLine::before { text-decoration: underline; }
46+
}
47+
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
48+
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
49+
code span.at { color: #7d9029; } /* Attribute */
50+
code span.bn { color: #40a070; } /* BaseN */
51+
code span.bu { } /* BuiltIn */
52+
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
53+
code span.ch { color: #4070a0; } /* Char */
54+
code span.cn { color: #880000; } /* Constant */
55+
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
56+
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
57+
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
58+
code span.dt { color: #902000; } /* DataType */
59+
code span.dv { color: #40a070; } /* DecVal */
60+
code span.er { color: #ff0000; font-weight: bold; } /* Error */
61+
code span.ex { } /* Extension */
62+
code span.fl { color: #40a070; } /* Float */
63+
code span.fu { color: #06287e; } /* Function */
64+
code span.im { } /* Import */
65+
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
66+
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
67+
code span.op { color: #666666; } /* Operator */
68+
code span.ot { color: #007020; } /* Other */
69+
code span.pp { color: #bc7a00; } /* Preprocessor */
70+
code span.sc { color: #4070a0; } /* SpecialChar */
71+
code span.ss { color: #bb6688; } /* SpecialString */
72+
code span.st { color: #4070a0; } /* String */
73+
code span.va { color: #19177c; } /* Variable */
74+
code span.vs { color: #4070a0; } /* VerbatimString */
75+
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
7776
</style>
7877
<link rel="stylesheet" href="github-pandoc.css" />
79-
<!--[if lt IE 9]>
80-
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
81-
<![endif]-->
82-
<link rel="Metafacture Icon" type="image/x-icon" href="/img/metafacture-icon.png">
78+
<link rel="Metafacture Icon" type="image/x-icon" href="./img/metafacture-icon.png">
8379
</head>
8480
<body>
8581

86-
<img src="/img/metafacture.png" alt="Metafacture" style="max-width:100%"/>
82+
<img src="./img/metafacture.png" alt="Metafacture" style="max-width:100%"/>
8783

8884
<center>
8985
<b>
90-
<a href="/index.html">Home</a>
86+
<a href="./index.html">Home</a>
9187
&ensp;|&ensp;
92-
<a href="/getting-started.html">Getting started</a>
88+
<a href="./getting-started.html">Getting started</a>
9389
&ensp;|&ensp;
9490
<a href="https://metafacture.github.io/metafacture-documentation/">Documentation</a>
9591
&ensp;|&ensp;
96-
<a href="/ide-extensions/index.html">IDE Extensions</a>
92+
<a href="./ide-extensions.html">IDE Extensions</a>
9793
&ensp;|&ensp;
9894
<a href="https://blog.metafacture.org">Blog</a>
9995
&ensp;|&ensp;
10096
<a href="https://metafacture.org/playground">Playground</a>
10197
&ensp;&ensp;
10298
</br>
103-
<a href='https://openbiblio.social/@metafacture'><img src='/img/Mastodon.png'/></a>
99+
<a href='https://openbiblio.social/@metafacture'><img src='./img/Mastodon.png'/></a>
104100

105-
<a href='https://twitter.com/metafacture'><img src='/img/Twitter.png'/></a>
106-
<a href='https://github.com/metafacture'><img src='/img/GitHub.png'/></a>
101+
<a href='https://twitter.com/metafacture'><img src='./img/Twitter.png'/></a>
102+
<a href='https://github.com/metafacture'><img src='./img/GitHub.png'/></a>
107103
</b>
108104
</center>
109105
<header id="title-block-header">
@@ -122,11 +118,11 @@ <h2 id="using-metafacture-as-a-java-library">Using Metafacture as a Java library
122118
<p>If you want to use Metafacture in your own Java projects all you need is to add some dependencies to your project. As of Metafacture 5, the single metafacture-core package has been replaced with a number of domain-specific packages. You can find the list of packages on <a href="https://search.maven.org/search?q=g:org.metafacture">Maven Central</a>.</p>
123119
<p>Alternatively, you can simply guess the package names from the top-level folders in the source code repository – they are the same.</p>
124120
<p>For instance, if you want to use the <code>metafacture-io</code> library in your project, simply add the following dependency to your <code>pom.xml</code>:</p>
125-
<div class="sourceCode" id="cb1"><pre class="sourceCode xml"><code class="sourceCode xml"><span id="cb1-1"><a href="#cb1-1"></a><span class="kw">&lt;dependency&gt;</span></span>
126-
<span id="cb1-2"><a href="#cb1-2"></a> <span class="kw">&lt;groupId&gt;</span>org.metafacture<span class="kw">&lt;/groupId&gt;</span></span>
127-
<span id="cb1-3"><a href="#cb1-3"></a> <span class="kw">&lt;artifactId&gt;</span>metafacture-io<span class="kw">&lt;/artifactId&gt;</span></span>
128-
<span id="cb1-4"><a href="#cb1-4"></a> <span class="kw">&lt;version&gt;</span>$VERSION<span class="kw">&lt;/version&gt;</span></span>
129-
<span id="cb1-5"><a href="#cb1-5"></a><span class="kw">&lt;/dependency&gt;</span></span></code></pre></div>
121+
<div class="sourceCode" id="cb1"><pre class="sourceCode xml"><code class="sourceCode xml"><a class="sourceLine" id="cb1-1" title="1"><span class="kw">&lt;dependency&gt;</span></a>
122+
<a class="sourceLine" id="cb1-2" title="2"> <span class="kw">&lt;groupId&gt;</span>org.metafacture<span class="kw">&lt;/groupId&gt;</span></a>
123+
<a class="sourceLine" id="cb1-3" title="3"> <span class="kw">&lt;artifactId&gt;</span>metafacture-io<span class="kw">&lt;/artifactId&gt;</span></a>
124+
<a class="sourceLine" id="cb1-4" title="4"> <span class="kw">&lt;version&gt;</span>$VERSION<span class="kw">&lt;/version&gt;</span></a>
125+
<a class="sourceLine" id="cb1-5" title="5"><span class="kw">&lt;/dependency&gt;</span></a></code></pre></div>
130126
<p>or if Gradle is your build tool of choice use:</p>
131127
<pre class="groovy"><code>dependencies {
132128
implementation &#39;org.metafacture:metafacture-io:$VERSION&#39;

‎getting-started.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Getting started"
33
header-includes:
4-
<link rel="Metafacture Icon" type="image/x-icon" href="/img/metafacture-icon.png">
4+
<link rel="Metafacture Icon" type="image/x-icon" href="./img/metafacture-icon.png">
55
---
66

77
## Playground

‎ide-extensions/index.html ‎ide-extensions.html

+18-23
Original file line numberDiff line numberDiff line change
@@ -5,43 +5,38 @@
55
<meta name="generator" content="pandoc" />
66
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
77
<title>Metafacture – IDE Extensions</title>
8-
<style>
9-
code{white-space: pre-wrap;}
10-
span.smallcaps{font-variant: small-caps;}
11-
span.underline{text-decoration: underline;}
12-
div.column{display: inline-block; vertical-align: top; width: 50%;}
13-
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
14-
ul.task-list{list-style: none;}
8+
<style type="text/css">
9+
code{white-space: pre-wrap;}
10+
span.smallcaps{font-variant: small-caps;}
11+
span.underline{text-decoration: underline;}
12+
div.column{display: inline-block; vertical-align: top; width: 50%;}
1513
</style>
16-
<link rel="stylesheet" href="../github-pandoc.css" />
17-
<!--[if lt IE 9]>
18-
<script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
19-
<![endif]-->
20-
<link rel="Metafacture Icon" type="image/x-icon" href="/img/metafacture-icon.png">
14+
<link rel="stylesheet" href="github-pandoc.css" />
15+
<link rel="Metafacture Icon" type="image/x-icon" href="./img/metafacture-icon.png">
2116
</head>
2217
<body>
2318

24-
<img src="/img/metafacture.png" alt="Metafacture" style="max-width:100%"/>
19+
<img src="./img/metafacture.png" alt="Metafacture" style="max-width:100%"/>
2520

2621
<center>
2722
<b>
28-
<a href="/index.html">Home</a>
23+
<a href="./index.html">Home</a>
2924
&ensp;|&ensp;
30-
<a href="/getting-started.html">Getting started</a>
25+
<a href="./getting-started.html">Getting started</a>
3126
&ensp;|&ensp;
3227
<a href="https://metafacture.github.io/metafacture-documentation/">Documentation</a>
3328
&ensp;|&ensp;
34-
<a href="/ide-extensions/index.html">IDE Extensions</a>
29+
<a href="./ide-extensions.html">IDE Extensions</a>
3530
&ensp;|&ensp;
3631
<a href="https://blog.metafacture.org">Blog</a>
3732
&ensp;|&ensp;
3833
<a href="https://metafacture.org/playground">Playground</a>
3934
&ensp;&ensp;
4035
</br>
41-
<a href='https://openbiblio.social/@metafacture'><img src='/img/Mastodon.png'/></a>
36+
<a href='https://openbiblio.social/@metafacture'><img src='./img/Mastodon.png'/></a>
4237

43-
<a href='https://twitter.com/metafacture'><img src='/img/Twitter.png'/></a>
44-
<a href='https://github.com/metafacture'><img src='/img/GitHub.png'/></a>
38+
<a href='https://twitter.com/metafacture'><img src='./img/Twitter.png'/></a>
39+
<a href='https://github.com/metafacture'><img src='./img/GitHub.png'/></a>
4540
</b>
4641
</center>
4742
<header id="title-block-header">
@@ -58,14 +53,14 @@ <h2 id="setup-a-vs-code-codium-extension">Setup a VS Code / Codium extension</h2
5853
<h2 id="usage">Usage</h2>
5954
<h3 id="flux">Flux</h3>
6055
<p>After installing the IDE extension to VS Code / Codium open a Flux file, for example <a href="https://gitlab.com/oersi/oersi-etl/-/blob/master/data/production/digill/digill-to-oersi.flux">this one</a>. It should look like this:</p>
61-
<p><img src="/img/digill-to-oersi_flux.JPG" alt="Flux editor" style="max-width:100%"/></p>
56+
<p><img src="./img/digill-to-oersi_flux.JPG" alt="Flux editor" style="max-width:100%"/></p>
6257
<p>If you delete for example a necessary bracket you will see in the Problems section that the extension detects problems with the Flux file:</p>
63-
<p><img src="/img/digill-to-oersi_flux_problem.JPG" alt="Flux editor with problems" style="max-width:100%"/></p>
58+
<p><img src="./img/digill-to-oersi_flux_problem.JPG" alt="Flux editor with problems" style="max-width:100%"/></p>
6459
<h3 id="fix">Fix</h3>
6560
<p>After installing the IDE extension to VS Code / Codium open a Flux file, for example <a href="https://gitlab.com/oersi/oersi-etl/-/blob/master/data/production/digill/digill.fix">this one</a>. It should look like this:</p>
66-
<p><img src="/img/digill_fix.JPG" alt="Fix editor" style="max-width:100%"/></p>
61+
<p><img src="./img/digill_fix.JPG" alt="Fix editor" style="max-width:100%"/></p>
6762
<p>If you remove a closing <code>end</code> you will see in the Problems section that the extension detects the missing <code>end</code>:</p>
68-
<p><img src="/img/digill_fix_problem.JPG" alt="Fix editor with problems" style="max-width:100%"/></p>
63+
<p><img src="./img/digill_fix_problem.JPG" alt="Fix editor with problems" style="max-width:100%"/></p>
6964
<h2 id="github">GitHub</h2>
7065
<p>To report issues, see the code, and contribute to the projects, visit: <a href="https://github.com/metafacture/metafacture-fix">Fix Repository</a>, <a href="https://github.com/metafacture/metafacture-flux">Flux Repository</a>.</p>
7166
</body>

‎ide-extensions/index.md ‎ide-extensions.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "IDE Extensions"
33
header-includes:
4-
<link rel="Metafacture Icon" type="image/x-icon" href="/img/metafacture-icon.png">
4+
<link rel="Metafacture Icon" type="image/x-icon" href="./img/metafacture-icon.png">
55
---
66

77
## Overview
@@ -22,21 +22,21 @@ There are different ways to install extensions for VS Code / Codium.
2222

2323
After installing the IDE extension to VS Code / Codium open a Flux file, for example [this one](https://gitlab.com/oersi/oersi-etl/-/blob/master/data/production/digill/digill-to-oersi.flux). It should look like this:
2424

25-
<img src="/img/digill-to-oersi_flux.JPG" alt="Flux editor" style="max-width:100%"/>
25+
<img src="./img/digill-to-oersi_flux.JPG" alt="Flux editor" style="max-width:100%"/>
2626

2727
If you delete for example a necessary bracket you will see in the Problems section that the extension detects problems with the Flux file:
2828

29-
<img src="/img/digill-to-oersi_flux_problem.JPG" alt="Flux editor with problems" style="max-width:100%"/>
29+
<img src="./img/digill-to-oersi_flux_problem.JPG" alt="Flux editor with problems" style="max-width:100%"/>
3030

3131
### Fix
3232

3333
After installing the IDE extension to VS Code / Codium open a Flux file, for example [this one](https://gitlab.com/oersi/oersi-etl/-/blob/master/data/production/digill/digill.fix). It should look like this:
3434

35-
<img src="/img/digill_fix.JPG" alt="Fix editor" style="max-width:100%"/>
35+
<img src="./img/digill_fix.JPG" alt="Fix editor" style="max-width:100%"/>
3636

3737
If you remove a closing `end` you will see in the Problems section that the extension detects the missing `end`:
3838

39-
<img src="/img/digill_fix_problem.JPG" alt="Fix editor with problems" style="max-width:100%"/>
39+
<img src="./img/digill_fix_problem.JPG" alt="Fix editor with problems" style="max-width:100%"/>
4040

4141
## GitHub
4242

0 commit comments

Comments
 (0)