Skip to content

Latest commit

 

History

History
81 lines (53 loc) · 2.96 KB

CONTRIBUTING.md

File metadata and controls

81 lines (53 loc) · 2.96 KB
Raw

forvaltningsstandard-begrepsbeskrivelser

For å bidra til utviklingen av denne standarden, må du clone den til din datamaskin og opprette en pull request.

Clone til din datamaskin

For at det følgende skal virke på din maskin, må du ha programvare installert:

Dersom du bruker Atom kan du gjøre som følger:

  • Trykk Ctrl+Shift+P
  • Skriv GitHub: Clone og trykk Enter
  • I Clone from legger du inn følgende url https://github.com/Informasjonsforvaltning/forvaltningsstandard-begrepsbeskrivelser.git

Alternativt i kommando-linje:

% git clone https://github.com/Informasjonsforvaltning/forvaltningsstandard-begrepsbeskrivelser.git
% cd forvaltningsstandard-begrepsbeskrivelser
% atom .                                # dersom du har installert Atom

Gjøre endringer

Denne standarden er laget i AsciiDoc med hjelp av verktøyet Asciidoctor.

Alle endringer må gjøre ved å endre eller legge til filer i docs-folderen. Se for eksempel på følgende veileder for god AsciiDoc praksis: https://asciidoctor.org/docs/asciidoc-recommended-practices

En typisk git-arbeidsflyt vil være som følger:

% git checkout develop
% git pull
% git checkout -b <ny branch>
% ... # gjør endringer i din valgte editor
% git add <filer som er endra>          # legger endringer klare for commit
% git commit -m "Fornuftig feilmeldng"  # utføre commit
% git push                              # publisere branch og gjøre klar for PR

Dersom du bruker Atom har du støtte for alt dette i Git-panelet.

Gå til https://github.com/Informasjonsforvaltning/forvaltningsstandard-begrepsbeskrivelser/pulls og opprett New pull request

Forhåndsvise

Dersom du bruker Atom editor kan du installere pakken AsciiDoc Assistant Package. Du vil da få syntax-uthevelse og forhåndsvisning.

Generere html og pdf lokalt

For at det følgende skal virke på din maskin, må du ha programvare installert:

% docker run -it -v $(pwd):/documents asciidoctor/docker-asciidoctor
bash-5.0# asciidoctor -a lang=nb -D docs -o index.html docs/main.adoc
bash-5.0# asciidoctor-pdf -a lang=nb -D docs -o forvaltningsstandard-begrepsbeskrivelser.pdf docs/main.adoc

Åpne filen index.html i din nettleser.

  • AsciidocFX er et annet alternativ for generering av html og pdf lokalt

Teste html i en webserver på din maskin

Dersom du vil teste html på en server på din maskin, kan du f.eks. installere Live Server For dette trenger du å installere Python på din datamaskin:

% python -m pip install --user live-server
% live-server docs

Åpne en nettleser og gå til http://localhost:8888