Detta projekt hanterar hjälpdokumentationen för Libris XL och paketering av densamma. Själva dokumentationen skrivs i markdown med YAML-metadata och paketeras till JSON.
Innehåll:
Kör npm install (testat med Node.js 14) för att installera nödvändiga saker.
Kör sedan npm run build för att bygga ihop en JSON-fil där all markdown är sorterad in i noder enligt avsnittens metadata.
Servera sedan build-foldern på lämpligt ställe.
Obs:
- Detta projekt hanterar inte konvertering av markdown till HTML. Det skall förslagsvis göras när man konsumerar JSON-strukturen i en applikation.
- Du behöver ta hänsyn till (och troligtvis konvertera) hänvisningar till bilder.
Filerna i mappen docs utgör hjälpdokumentationen för gränssnittet. Om det i denna mapp skapas, ändras eller redigeras så kommer de ändringarna att komma in i gränssnittet.
Förstasidan redigeras i filen index.md.
Överst i varje dokumentationsfil finns ett par rader som definierar ett par egenskaper på dokumentet, t ex vilken kategori den tillhör och vilken titel den ska få.
---
section: Sök
title: Träfflista
order: 1
date: 2018-01-01
tags:
- search
---
Section:
Kategori på dokumentet. Används till exempel för att lägga dokumenten bredvid varandra i menyn.
Title:
Titel på dokumentet. Används till menyn. Används inte till rubriker i dokumentet.
Valfritt Order:
Ordning inom kategorin i menyn. Högre siffra -> Längre ner inom kategorin. Avsnitt som saknar order-attributet hamnar alltid längre ner än de som har attributet.
Valfritt Date:
Datum i YYYY-MM-DD format. Ska ej ha citationstecken. Exempel: 2018-05-23
Om date inte anges så kommer ej "Uppdaterad NN dagar sedan" att synas.
Valfritt Tags:
Etiketter på dokumentet som eventuellt skulle kunna användas till sökning. Lägg till under arbete för att visa en notis högs upp i dokumentet.
Under egenskaperna följer sedan själva innehållet i avsnittet. Man använder sig av markdown för att strukturera rubriker, länkar, bilder etc.
För att bilderna ska kunna paketeras och visas korrekt, lägg bilden i mappen img och lägg till bilden i dokumentet med följande kod. Obs måste vara av formatet .png.
