Fusion site ssplab

.github/workflows/dev.yaml

@@ -63,7 +63,6 @@ jobs:
           preview-branch: ${{ env.PREVIEW_BRANCH }}
           action: deploy
           comment: false
-          pr_number: ${{ github.event.pull_request.number }}
 
       - name: Comment PR (custom)
         uses: marocchino/sticky-pull-request-comment@v2
@@ -98,4 +97,3 @@ jobs:
             Preview removed because the pull request was closed.
             ${{ steps.remove-preview.outputs.action-start-time }}
 
-

.github/workflows/prod.yaml

@@ -33,3 +33,5 @@ jobs:
           target: netlify
           NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
           NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}
+
+

.gitignore

@@ -9,7 +9,24 @@ node_modules/
 go.sum
 .hugo_build.lock
 
+# Quarto
+_freeze/
+*.html
+*.json
+*.feed*
+site_libs/
+
+# For gh-pages
 /.quarto/
 _site/
+
 rp_parquet/
+*.quarto_ipynb
 **/*.quarto_ipynb
+course_files/
+
+# Venv
+.venv/
+*/.venv/
+__pycache__/
+*/__pycache__/

CONTRIBUTING.md

@@ -147,7 +147,7 @@ Pour des sujets plus transversaux, ou pour discuter avec les autres
 membres du réseau, il est possible de rejoindre le salon de discussion dédié
 sur le service de messagerie `Tchap`. Il s'agit d'un salon privé auquel vous
 pouvez demander l'accès en envoyant un message privé à Lino Galiana ou un
-mail à ssphub-contact@insee.fr
+mail à {{< var contact.email >}}
 
 ## :four: Comment ajouter une référence dans l'une des rubriques événements, ressources ou projets ? 
 

README.md

@@ -1,8 +1,103 @@
-# Site web du réseau des data scientists du service statistique public
+# Website of the data scientists of the French Official Statistical System
 
-Code source du `SSPHub`, le site du réseau des 
-_data scientists_ du service statistique public (SSP).
+Code of the [`SSPHub`](https://ssphub.netlify.app.), a website for data scientists of the French Official Statistical System.
 
-Contenu disponible sur https://ssphub.netlify.app.
+# How to use this repo ?
+## Set up
+Assumes you have an account on [https://datalab.sspcloud.fr/](https://datalab.sspcloud.fr/)
+- Open a service (VSCode or other IDE) with **R installed**
+- Github account, (with credentials to InseeFrLab/ssphub if you want to deploy the website)
+
+## How to contribute
+Specified in [contributing.md](CONTRIBUTING.md)
+
+## How to
+
+### Render / preview when coding
+- render: `Rscript scripts/render.R`
+- preview: `Rscript scripts/preview.R`
+- render and preview : `Rscript scripts/render.R && Rscript scripts/preview.R`
+
+If a PR is opened, a website preview is automatically generated. The link to the preview is in the Github PR details. Every push to the remote repo will trigger an update of the website preview.
+
+###  Create a project
+used with Python. `create_folder_and_file("2022_JOCAS")`
+
+```{shell}
+cd scripts
+uv sync
+uv run template.py name_of_the_folder (optional: name_of_the_template.qmd)
+```
+
+Example :
+```{shell}
+cd scripts
+uv sync
+uv run template.py test
+```
+
+
+### Harmonization of categories
+private data sources : introduce code snippets for YAML part.
+```{json}
+	"add private data tags (FR)": {
+		"prefix": "prdata",
+		"body": "    - données de caisse\n    - données de téléphonie mobile\n    - données CB\n    - données comptes bancaires",
+		"description": "adds categories for listing of similar projects related to private data sources"
+	},
+
+	"add private data tags (EN)": {
+		"prefix": "en_prdata",
+		"body": "    - scanner data\n    - mobile phone data\n    - credit card data\n    - bank account data",
+		"description": "adds categories for listing of similar projects related to private data sources"
+	},
+```
+When a new category is created, do a find and replace all to add this category to all the listing to ensure consistency.
+
+### Translate a page to english
+Config :
+- have a deepl API KEY stored as `DEEPL_API_KEY`
+- working directory must be ssphub/scripts
+
+```{shell}
+# it will take the "index.qmd" file of the project/project_subdir dir and translate it into "index.en.qmd
+Rscript translate.R project_subdir
+```
+
+Example
+```{shell}
+Rscript scripts/translate.R 2023_doremifasol
+```
+
+
+Have a careful check with the proposed translated webpage. The automated translation often
+adds a backslash or "-" at some spots that creates bugs when rendering the website. For example :
+    - `description: | -` for `description: |`
+    - `{{\< fa brands github >}}` for `{{< fa brands github >}}`
+    - Markdown table structure contains many whitespace and ---
+The translate programm removes some issues but not all. It deletes all "\", multiple spaces and multiple "----".
+But some ENTER remain, and it doesn't translate categories of listing.
+A careful look is needed :
+- listing categories in the YAML part must be translated
+- inside Qmd table to ensure that a row is always coded in 1 line of code.
+
+### Publish
+Publishing is automated with CI in the [prod.yaml](.github/workflows/prod.yaml) file.
+
+# Credits
+Thanks to :
+
+- [babelquarto](https://docs.ropensci.org/babelquarto/)
+- Quarto
+
+# Personnal
+
+## To do
+- speed up R set up in Github actions (with renv? / dependencies set to '"hard"'?)
+- move image to S3 to have smaller repo (impact on newsletter download image function)
+- have a developpement Quarto profile ?
+- doublon blog/polars/polars-tuto.qmd et additional/notebooks
+
+## Useful
+- init.sh ??
 
-Site web construit avec `Quarto`

_quarto-en.yml

@@ -0,0 +1,16 @@
+website:
+  description: "Network of data scientists working for the French administration"
+  navbar:
+    search: true
+    right:
+      - icon: github
+        href: https://github.com/InseeFrLab/ssphub
+    left:
+      - href: index.qmd
+        text: "Home"
+      - href: about.qmd
+        text: "About the SSPHub"
+      - href: https://datalab.sspcloud.fr/
+        text: "SSPCloud"
+
+lang: en-GB

_quarto-fr.yml

@@ -0,0 +1,39 @@
+website:
+  description: "Blog du réseau des data scientists de la statistique publique"
+  navbar:
+    search: true
+    right:
+      - icon: rss
+        href: index.xml
+      - icon: github
+        href: https://github.com/InseeFrLab/ssphub
+    left:
+      - href: index.qmd
+        text: "Accueil"
+      - href: event.qmd
+        text: "Événements"
+      - href: blog.qmd
+        text: "Blog"
+      - href: project.qmd
+        text: "Projets"
+      - href: course.qmd
+        text: "Ressources utiles"
+      - text: "À propos"
+        menu:
+          - href: infolettre/infolettre.qmd
+            text: "Newsletters"
+          - href: about.qmd
+            text: "Présentation du réseau"
+          - href: manifeste.qmd
+            text: "Manifeste du réseau"
+      - href: https://datalab.sspcloud.fr/
+        text: "Le SSPCloud"
+
+  announcement:
+    icon: bi-megaphone
+    dismissable: true
+    content: "📺️ Les présentations et le replay de la journée du réseau, le 1^er^ décembre 2025, [sont disponibles](/event/2025-12-01-network-day/index.qmd)"
+    type: primary
+    position: below-navbar
+
+lang: fr

_quarto.yml

@@ -3,62 +3,54 @@ project:
   render:
     - index.qmd
     - about.qmd
-    - course.qmd
-    - blog.qmd
-    - event.qmd
-    - talk/**/*.qmd
-    - additional/manifeste.qmd
+    - manifeste.qmd
     - "!additional/notebooks/*.qmd"
-    - infolettre/*.qmd
-    - infolettre/**/*.qmd
-    - post/**/*.qmd
-    - partenaires/**/*.qmd
-    - course/**/*.qmd
+    - blog.qmd
+    - blog/**/*.qmd
     - "!*/parquetRP/snippets/*"
     - "!*/polars/polars-tuto.qmd"
+    - course.qmd
+    - course/**/*.qmd
+    - event.qmd
+    - event/**/index.qmd
+    - infolettre/infolettre.qmd
+    - infolettre/**/index.qmd
+    - partenaires/**/index.qmd
+    - project.qmd
+    - project/**/*.qmd
+    # English version - dealt with babelquarto and not with Quarto profiles
+    - '*.en.qmd'
+
+website:
+  title: "SSPHub"
+  # site-url: https://ssphub.netlify.app/  # For production
+  site-url: https://InseeFrLab.github.io/ssphub/pr-preview/pr-112/  # when PR open
+  # site-url: https://user-nicolastlm-497263-0.user.lab.sspcloud.fr/proxy/4321/  # For dev
+  repo-url: https://github.com/InseeFrLab/ssphub
+  repo-actions: [source, issue, edit]
 
 title-block-banner: "#6886bb"
 title-block-banner-color: white
 
-website:
-  title: "SSPHub"
-  navbar:
-    search: true
-    right:
-      - icon: rss
-        href: index.xml
-    left:
-      - href: index.qmd
-        text: "Home"
-      - href: event.qmd
-        text: "Événements"
-      - href: infolettre/index.qmd
-        text: "Newsletters"
-      - href: blog.qmd
-        text: "Blog"
-      - href: course.qmd
-        text: "Ressources utiles"
-      - text: "À propos"
-        menu:
-          - href: about.qmd
-            text: "Présentation du réseau"
-          - href: additional/manifeste.qmd
-            text: "Manifeste du réseau"
-      - href: https://datalab.sspcloud.fr/
-        text: "Le SSPCloud"
-      - icon: github
-        href: https://github.com/InseeFrLab/ssphub
-  site-url: https://ssphub.netlify.app/
-  description: "Blog du réseau des data scientists de la statistique publique"
-  announcement:
-    icon: bi-megaphone
-    dismissable: true
-    content: "📺️ Les présentations et le replay de la journée du réseau, le 1^er^ décembre 2025, [sont disponibles](/talk/2025-12-01-network-day/index.qmd)"
-    position: below-navbar
+profile:
+  default: fr
+  group: [fr, en]
 
 format:
   html:
-    theme: [cosmo, styles.scss]
+    theme: [cosmo, assets/scss/styles.scss]
     toc: true
     page-layout: article
 
+babelquarto:
+  languagelinks: navbar
+  languagecodes:
+  - name: en
+    text: "🇬🇧 English"
+  - name: fr
+    text: "🇫🇷 Français"
+  mainlanguage: 'fr'
+  languages: ['en']
+  icon: ""  # No bootstrap icon
+
+

_variables.yml

@@ -0,0 +1,12 @@
+
+contact:
+  email: <contact-ssphub@insee.fr>
+  tchap: https://tchap.gouv.fr/#/room/#ssphub:agent.finances.tchap.gouv.fr
+
+signup:
+  form: https://grist.numerique.gouv.fr/o/ssphub/forms/jSjAV3L2F8mmiRVuVEpfF7/103
+  fiche: https://grist.numerique.gouv.fr/o/ssphub/iTFX7gryL8jK/Annuaire?utm_id=share-doc
+
+site:
+  url: https://ssphub.netlify.app/
+  github: https://github.com/InseeFrLab/ssphub

about.en.qmd

@@ -0,0 +1,37 @@
+---
+title: The SSPHub, the network for data scientists
+---
+
+# The SSPHub, the network for data scientists
+
+The network of [Official Statistical System (SSP)](https://www.insee.fr/en/information/2386424) data scientists is made up mainly, but not exclusively, of **the government departments responsible for producing official statistics** (mainly INSEE and ministerial statistical departments).
+
+The network has several objectives, the main ones being:
+
+- The **sharing and disseminating knowledge** within the *data scientists* community around the practices and innovations of the *data-science* ;
+- The **innovative work** in the field of statistical production ;
+- Facilitate **exchanges between peers** The aim is to facilitate exchanges between peers, whether or not they belong to the official statistical service.
+
+In order to better define the objectives, target audience, themes addressed by the network, and associated resources, a [manifesto ](manifeste.html) was drafted collectively.
+
+# Would you like to join the network?
+
+The network is open to anyone working in the production of official statistics and more widely in the civil service.
+There are various ways in which you can join, but exchanges are (surprisingly😱) in French 🇫🇷 :
+
+- You can join our discussion channel [`Tchap`]({{< var contact.tchap >}}) ;
+- You can receive the newsletter by registering [here]({{< var signup.form >}}) ;
+- You can take part in the creation of content on this site at [our `Github` {{< fa brands github >}}]({{< var contact.email >}}) ;
+- If you have any questions, would like to chat, etc., you can also send an e-mail to {{< var contact.email >}}.
+
+# The SSP Lab, INSEE's data science innovation laboratory, which also runs the SSPHub.
+
+The SSPLab also manages the SSPHub network.
+The SSPLab is an INSEE unit (equivalent to a division or office) which was created following the Insee-2025 medium-term strategy reflections. [^1] .
+Part of the Methodology, Statistical and International Coordination Directorate (the famous DMCSI), the SSP Lab **promotes innovation and novelty in data sources, technologies and data science methods**.
+To this end, it conducts experimental projects in support of the sponsoring departments responsible for producing official statistics (including SSMs outside INSEE, INSEE's business divisions and regional directorates).
+It also provides **monitoring role** and **dissemination of innovative statistical methods** co-organises the SSPHub and acts as a link between **external partners** in areas within its remit (research laboratories, European peers).
+
+[^1]: More details are available on the Insee website [here (French)](https://www.insee.fr/fr/information/3559883)
+
+