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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: ssb-pubmd
3
- Version: 0.1.6
3
+ Version: 0.1.8
4
4
  Summary: SSB Pubmd
5
5
  License: MIT
6
6
  Author: Olav Landsverk
@@ -1,6 +1,6 @@
1
1
  [tool.poetry]
2
2
  name = "ssb-pubmd"
3
- version = "0.1.6"
3
+ version = "0.1.8"
4
4
  description = "SSB Pubmd"
5
5
  authors = ["Olav Landsverk <stud-oll@ssb.no>"]
6
6
  license = "MIT"
@@ -92,6 +92,7 @@ class Highchart(MimirContent):
92
92
  "tbprocessor": {"urlOrId": self.tbml},
93
93
  }
94
94
 
95
+ s["data"]["graphType"] = self.graph_type
95
96
  s["data"]["xAxisTitle"] = self.xlabel
96
97
  s["data"]["yAxisTitle"] = self.ylabel
97
98
 
@@ -15,22 +15,21 @@ Dette er en SSB-artikkel skrevet med Quarto Markdown.
15
15
 
16
16
  Neste steg:
17
17
 
18
- 1. Sjekk at du er logget inn i CMS-et: {{ cms_admin_url }}/tool/com.enonic.app.contentstudio/main.
18
+ 1. Logg deg inn i CMS'et: {{ cms_admin_url }}/tool/com.enonic.app.contentstudio/main.
19
19
 
20
- 2. Det er gitt et eksempel på CMS-mappe i feltet `path` ovenfor. Endre denne til CMS-mappen du ønsker å opprette artikkelen i. Dette må være en mappe du har skrivetilgang til.
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 URL'en til en forhåndsvisning av artikkelen.
25
- * Kommandoen fungerer tilsvarende som `quarto preview`, det vil si at forhåndsvisningen holdes oppdatert etter hvert som du endrer og lagrer denne filen.****
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. Les seksjonene nedenfor for en kort introduksjon til skriving av SSB-artikler i Quarto Markdown.
27
+ 4. Under følger en kort introduksjon til skriving av SSB-artikler med Quarto Markdown.
29
28
 
30
29
  ## Artikkelmetadata
31
30
 
32
- Metadata-blokken øverst viser all metadata som kan settes for en artikkel.
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 et begrenset utvalg SSB-komponenter.
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
- Importér Python-pakken:
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
- Kodeblokkene nedenfor viser opprettelse av to komponenter; et highchart og en faktaboks:
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: (link kommer).
101
- * For å se alle funksjonene som tilbys, skriv `ssb.` på en kodelinje og tast `Ctrl + Space` (VSCode) eller `Tab` (Jupyterlab).
102
- * VSCode: Dokumentasjonen til funksjonen vises automatisk i en popup-boks når man hovrer over funksjonen.
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 av kodeblokkene ovenfor, vil det printes en Markdown-snippet som kan kopieres og limes inn på en ny linje:
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 å ha synkronisert denne filen til CMS'et, vil du se en ekstra fil i Dapla-tjenesten:
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