ssb-pubmd 0.1.6__tar.gz → 0.1.8__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/PKG-INFO +1 -1
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/pyproject.toml +1 -1
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/adapters/content_parser.py +1 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/templates/template.qmd +27 -19
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/LICENSE +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/README.md +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/__init__.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/__main__.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/adapters/document_processor.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/adapters/publish_client.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/adapters/storage.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/cli.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/config.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/domain/document_publisher.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/notebook_client.py +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/py.typed +0 -0
- {ssb_pubmd-0.1.6 → ssb_pubmd-0.1.8}/ssb_pubmd/templates/__init__.py +0 -0
|
@@ -15,22 +15,21 @@ Dette er en SSB-artikkel skrevet med Quarto Markdown.
|
|
|
15
15
|
|
|
16
16
|
Neste steg:
|
|
17
17
|
|
|
18
|
-
1.
|
|
18
|
+
1. Logg deg inn i CMS'et: {{ cms_admin_url }}/tool/com.enonic.app.contentstudio/main.
|
|
19
19
|
|
|
20
|
-
2.
|
|
20
|
+
2. Endre feltet `path` ovenfor til ønsket CMS-mappe, og sjekk at du har skrivetilgang i mappen.
|
|
21
21
|
|
|
22
22
|
3. Kjør kommandoen `poetry run ssb-pubmd preview {{ filepath }}`.
|
|
23
23
|
|
|
24
|
-
* Dette vil opprette en draft-artikkel og printe
|
|
25
|
-
* Kommandoen fungerer tilsvarende som `quarto preview`, det vil si at forhåndsvisningen
|
|
26
|
-
* Du må oppdatere nettleservinduet for å se endringene.
|
|
24
|
+
* Dette vil opprette en draft-artikkel og printe en forhåndsvisningslink.
|
|
25
|
+
* Kommandoen fungerer tilsvarende som `quarto preview`, det vil si at forhåndsvisningen oppdateres når du endrer og lagrer denne filen (du må oppdatere nettleservinduet).****
|
|
27
26
|
|
|
28
|
-
4.
|
|
27
|
+
4. Under følger en kort introduksjon til skriving av SSB-artikler med Quarto Markdown.
|
|
29
28
|
|
|
30
29
|
## Artikkelmetadata
|
|
31
30
|
|
|
32
|
-
|
|
33
|
-
Dette er noe begrenset i testversjonen, men vil senere være komplett.
|
|
31
|
+
Metadatablokken øverst viser all metadata som kan settes for en artikkel.
|
|
32
|
+
Dette er noe begrenset i testversjonen, men vil senere være mer komplett.
|
|
34
33
|
Merk at `path` og `title` er obligatoriske felt.
|
|
35
34
|
|
|
36
35
|
|
|
@@ -50,20 +49,23 @@ Se [Quarto-referansen](https://quarto.org/docs/computations/python.html). Merk a
|
|
|
50
49
|
|
|
51
50
|
## SSB-komponenter
|
|
52
51
|
|
|
53
|
-
I testversjonen tilbys
|
|
52
|
+
I testversjonen tilbys to SSB-komponenter; highchart og faktaboks.
|
|
53
|
+
Dette vil senere utvides.
|
|
54
54
|
Komponentene opprettes med Python og settes inn med Markdown.
|
|
55
55
|
|
|
56
56
|
### Opprette komponenter
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
Vi importerer først `ssb_pubmd` sammen med andre nødvendige pakker:
|
|
59
59
|
|
|
60
60
|
```{python}
|
|
61
61
|
import ssb_pubmd as ssb
|
|
62
|
+
import pandas as pd
|
|
62
63
|
```
|
|
63
64
|
|
|
64
|
-
|
|
65
|
+
(I dette eksempelet brukes `pandas`; sørg for at det er installert med `poetry add pandas`, eller `poetry add "pandas<3"` for eldre Python-versjoner.)
|
|
66
|
+
|
|
67
|
+
Kodeblokkene nedenfor viser opprettelse av to komponenter:
|
|
65
68
|
```{python}
|
|
66
|
-
import pandas as pd
|
|
67
69
|
data = {
|
|
68
70
|
"År": [
|
|
69
71
|
2000, 2001, 2002, 2003, 2004,
|
|
@@ -97,13 +99,19 @@ ssb.Factbox(
|
|
|
97
99
|
display_type = "default")
|
|
98
100
|
```
|
|
99
101
|
|
|
100
|
-
Dokumentasjon
|
|
101
|
-
|
|
102
|
-
|
|
102
|
+
Dokumentasjon for opprettelse av komponenter:
|
|
103
|
+
|
|
104
|
+
```{python}
|
|
105
|
+
ssb.Factbox?
|
|
106
|
+
```
|
|
103
107
|
|
|
108
|
+
```{python}
|
|
109
|
+
ssb.Highchart?
|
|
110
|
+
```
|
|
104
111
|
### Sette inn komponenter
|
|
105
112
|
|
|
106
|
-
Når du kjører en
|
|
113
|
+
Når du kjører en kodecelle som oppretter en komponent, vil den printe en Markdown-snippet.
|
|
114
|
+
Denne kan kopieres og limes inn i artikkelen:
|
|
107
115
|
|
|
108
116
|
::: { #my-highchart .ssb }
|
|
109
117
|
:::
|
|
@@ -123,12 +131,12 @@ Ny paragraf.
|
|
|
123
131
|
|
|
124
132
|
## Synkronisering
|
|
125
133
|
|
|
126
|
-
Etter
|
|
134
|
+
Etter synkronisering har vi følgende mappestruktur:
|
|
127
135
|
|
|
128
136
|
```
|
|
129
137
|
{{ project_folder }}/
|
|
130
|
-
├── {{ filename }}
|
|
131
|
-
├── .ssbno.json
|
|
138
|
+
├── {{ filename }} (denne filen)
|
|
139
|
+
├── .ssbno.json (metadatafil)
|
|
132
140
|
```
|
|
133
141
|
|
|
134
142
|
Metadatafilen `.ssbno.json` er automatisk generert og inneholder metadata for den tilhørende CMS-artikkelen. Merk at:
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|