Auf Basis der semantischen RDF-Ressourcen des Modulkatalogs im Master-Studiengang Wirtschaftsinformatik werden statische HTML-Seiten mit einer PDF-Export-Funktion mithilfe von Jekyll-RDF generiert. Der Prototyp wird im Rahmen des Moduls "Enterprise Knowledge Graph Implementation" entwickelt und ist unter http://univera.de/FHB/EKGI_ModCat/ erreichbar.
- Ruby >= 2.1
- RubyGems
- Bundler
- Jekyll
- Jekyll-RDF
Die Parameter, die für Konfiguration von Jekyll-RDF nötig sind, befinden sich in _config.yml. url und baseurl werden verwendet, um den Pfad der Hauptressourcen im Root-Pfad umzufassen. Plugin sowie der Pfad der RDF-Ressource (Wissensbasis) müssen definiert werden.
baseurl: ""
url: "https://bmake.th-brandenburg.de/module"
plugins:
- jekyll-rdf
jekyll_rdf:
path: "_data/graph.ttl"
Außerdem gibt es die Möglichkeit, in der _config.yml die zu generierenden Seiten anhand einer SparQL-Query zu beschränken oder die Ressourcen den Templates zuzuordnen. Z. B. Die Seiten aller Ressourcen, die einen Typ von "https://schema.org/Course" besitzen, werden mit dem Template "course.html" erstellt.
restriction: "SELECT ?resourceUri WHERE { { ?resourceUri a <https://schema.org/Course> . } UNION { ?resourceUri a <https://schema.org/WebPage> } UNION { ?resourceUri a <https://bmake.th-brandenburg.de/module/Lecturer>.}}"
class_template_mappings:
"https://schema.org/WebPage": "index.html"
"https://schema.org/Course": "course.html"
"https://bmake.th-brandenburg.de/module/Lecturer": "person.html"Hier handelt es sich um Liquid-Templates. Im Folgenden werden einige Beispiele aus dem Template "course.html" angezeigt.
Die Seite wird mit einer Hauptressource aufgebaut, die später als Subjekt für alle SparQL-Queries verwendet wird.
{{ page.rdf }}
Englische Modulbeizeichung: {{ page.rdf | rdf_property: '<https://schema.org/name>','en'}}
Da es mehrere Objekte gibt, wird ein Array zurückgegeben. Um die Werte im Array anzuzeigen, wird eine For-Schleife gebraucht.
<ul>
{% assign results = page.rdf | rdf_property: '<https://schema.org/learningResourceType>', nil, true %}
{% for res in results %}
<li> {{res}}<br /></li>
{% endfor %}
</ul>
Darüber hinaus gibt es die Möglichkeit, die Ressoucen über mehrere verkettete Knoten mit SparQL abzufragen. ?resourceUri ist hier ein Platzhalter, der später durch {{ page.rdf.iri }} (IRI für die Hauptressource der Seite) ersetzt wird.
<td>
{% assign instructor_query = 'SELECT DISTINCT ?person WHERE {?resourceUri <https://schema.org/accountablePerson> ?person. }' %}
{% assign resultset = page.rdf | sparql_query: instructor_query %}
{% for result in resultset %}
{{ result.person | rdf_property: '<http://www.w3.org/2000/01/rdf-schema#label>' }}<br />
{% endfor %}
</td>
oder
<td>
{% capture instructor_query %}
SELECT DISTINCT ?instructor WHERE {?resourceUri <https://schema.org/hasCourseInstance> ?instance. ?instance a <https://schema.org/CourseInstance>; <https://schema.org/instructor> ?instructor.}
{% endcapture %}
{% assign resultset = page.rdf | sparql_query: instructor_query %}
{% for result in resultset %}
{{ result.person | rdf_property: '<http://www.w3.org/2000/01/rdf-schema#label>' }}<br />
{% endfor %}
</td>
Als erstes wird die Library von github.com/MrRio/jsPDF (jsPDF.min.js) eingebunden werden.
<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf/1.3.2/jspdf.min.js"></script>
Also nächstes wird das PDF-Objekt erzeugt sowie das Format (p= Porträt, pt=Punkte, a4 = Seitengröße) erstellt. Die ID "modulkatalog" muss auch bei der HTML Tabelle definiert werden.
var doc = new jsPDF('p', 'pt', 'a4');
var elem = document.getElementById('modulkatalog');
var data = doc.autoTableHtmlToJson(elem);
Auf Grund der automatischen Erstellung der Seiten entstehen Leerzeichen im HTML Code. Diese Leerzeichen müssen für die Darstellung des PDFs entfernt bzw. ersetzt werden.
var body = JSON.stringify(data).replace(/\\t+/g, '');
body = body.replace(/((\\n(\s)?)+)?(\\n\s)+/g, '');
body = body.replace(/\s\s+/g, '\\n');
body = JSON.parse(body);
Hier wird die Farbe der Kopfzeile, der Abstand links, die Breite der Tabelle sowie die Schriftgröße definiert. Anschließend wird die Tabelle als Modulkatalog.pdf gespeichert.
doc.autoTable(body.columns, body.rows, {
headerStyles: {
fillColor: [241, 132, 0],
},
margin: {left: 35},
theme: 'grid',
tableWidth: 'auto',
fontSize: 8,
overflow: 'linebreak',
}
);
doc.save('Modulkatalog.pdf');
}
Abschließend muss die PDF noch gespeichert werden, dies sollte mit einem Link oder Button erfolgen, da sonst das PDF direkt beim Seitenaufruf ausgegeben wird.
<button onclick="generatePDF()">Export als PDF</button>
Jekyll-RDF ist die Voraussetzung für dieses Projekt. Um Jekyll-RDF zu installieren und das Projekt zu starten, bitte das Tutorium für Jekyll-RDF referenzieren.