Align facodi-docs repo with multilingual structure

.gitignore

@@ -1,6 +1,9 @@
 .env
+.env.local
 .netlify
 .hugo_build.lock
-node_modules
+node_modules/
+.cache/
 public
 resources
+.DS_Store

README.md

@@ -1,4 +1,6 @@
-# FACODI — Faculdade Comunitária Digital
+# FACODI — Catálogo de Conteúdo (`facodi-docs`)
+
+Este repositório concentra o conteúdo versionado e a configuração Hugo/Supabase que sustentam o catálogo estático da FACODI. Ele substitui o antigo pacote `facodi.pt`, mantendo apenas Markdown, configurações e automações descritas no plano `facodi-docs`.
 
 A **FACODI** é uma plataforma de aprendizagem aberta que replica planos curriculares da Universidade do Algarve (UAlg) em formato digital. Todo o conteúdo é escrito em Markdown, sincronizado com o Supabase e disponibilizado como um site estático construído com [Hugo](https://gohugo.io/) (tema Doks).
 
@@ -12,7 +14,7 @@ A **FACODI** é uma plataforma de aprendizagem aberta que replica planos curricu
 - 🎓 Unidades curriculares com ementa, resultados de aprendizagem e tópicos
 - 🎥 Playlists abertas do YouTube organizadas por prioridade
 - 📝 Conteúdo em Markdown sincronizado automaticamente com o Supabase
-- 🌐 Multilíngue (PT como padrão, EN preparado como fallback)
+- 🌐 Multilíngue (PT, EN, ES e FR, com navegação consistente entre diretórios)
 
 ---
 
@@ -28,20 +30,29 @@ A **FACODI** é uma plataforma de aprendizagem aberta que replica planos curricu
 ## 📂 Estrutura do repositório
 
 ```bash
-facodi.pt/
+facodi-docs/
 ├─ README.md
 ├─ config/
 │  └─ _default/
 ├─ content/
-│  ├─ _index.md
-│  └─ courses/
-│     └─ LESTI/
-│        └─ 2024-2025/
-│           ├─ index.md           # Curso
-│           └─ uc/
-│              └─ LESTI-ALG1/
-│                 ├─ index.md     # Unidade curricular
-│                 └─ estruturas-de-dados.md  # Tópico
+│  ├─ pt/
+│  │  ├─ _index.md
+│  │  └─ courses/
+│  │     └─ LESTI/
+│  │        └─ 2024-2025/
+│  │           ├─ index.md           # Curso
+│  │           └─ uc/
+│  │              └─ LESTI-ALG1/
+│  │                 ├─ index.md     # Unidade curricular
+│  │                 └─ estruturas-de-dados.md  # Tópico
+│  ├─ en/_index.md
+│  ├─ es/_index.md
+│  └─ fr/_index.md
+├─ i18n/
+│  ├─ pt.toml
+│  ├─ en.toml
+│  ├─ es.toml
+│  └─ fr.toml
 ├─ layouts/
 │  ├─ _default/baseof.html
 │  ├─ course/single.html
@@ -51,6 +62,9 @@ facodi.pt/
 │  └─ js/
 │     ├─ loaders.js
 │     └─ supabaseClient.js
+├─ scripts/
+│  ├─ validate-frontmatter.js
+│  └─ sync-content.mjs
 ├─ supabase/
 │  ├─ migrations/
 │  │  └─ ... sql
@@ -63,6 +77,14 @@ facodi.pt/
 
 ---
 
+## 📐 Arquitetura e separação de responsabilidades
+
+- **Hugo (`facodi-docs`)**: entrega o catálogo estático com i18n, layouts customizados e carregadores JavaScript leves. O build usa apenas variáveis de ambiente fornecidas pela plataforma de deploy, sem chaves persistidas em arquivos de configuração.
+- **Portal dinâmico (Next.js)**: continuará responsável por experiências autenticadas e interativas. Ele deverá consumir os mesmos dados do Supabase por meio de chamadas client-side, mantendo a separação entre conteúdo estático e funcionalidades do portal.
+- **Automação**: os scripts `validate-frontmatter` e `sync-content` são executados localmente ou via GitHub Actions para garantir que o Markdown siga o esquema Supabase e que a sincronização aconteça apenas a partir do serviço (sem chaves embutidas).
+
+---
+
 ## 🛠️ Scripts disponíveis
 
 | Script | Descrição |

config/_default/hugo.toml

@@ -10,7 +10,7 @@ rssLimit = 10
 summarylength = 40
 
 defaultContentLanguage = "pt"
-defaultContentLanguageInSubdir = false
+defaultContentLanguageInSubdir = true
 
 copyRight = "FACODI — Conteúdo aberto para aprendizagem comunitária"
 

config/_default/languages.toml

@@ -1,6 +1,6 @@
 [pt]
   languageName = "Português"
-  contentDir = "content"
+  contentDir = "content/pt"
   weight = 1
   [pt.params]
     languageISO = "PT"
@@ -14,4 +14,22 @@
   [en.params]
     languageISO = "EN"
     languageTag = "en-US"
-    footer = 'Built by the FACODI community. English content coming soon.'
+    footer = 'Built by the FACODI community with Hugo and Supabase.'
+
+[es]
+  languageName = "Español"
+  contentDir = "content/es"
+  weight = 3
+  [es.params]
+    languageISO = "ES"
+    languageTag = "es-ES"
+    footer = 'Construido por la comunidad FACODI con Hugo y Supabase.'
+
+[fr]
+  languageName = "Français"
+  contentDir = "content/fr"
+  weight = 4
+  [fr.params]
+    languageISO = "FR"
+    languageTag = "fr-FR"
+    footer = 'Construit par la communauté FACODI avec Hugo et Supabase.'

config/_default/menus/menus.en.toml

@@ -4,6 +4,6 @@
   weight = 10
 
 [[footer]]
-  name = "Open Source"
+  name = "Community"
   url = "https://github.com/Monynha-Softwares/facodi.pt"
   weight = 10

config/_default/menus/menus.es.toml

@@ -0,0 +1,9 @@
+[[main]]
+  name = "Cursos"
+  url = "/"
+  weight = 10
+
+[[footer]]
+  name = "Comunidad"
+  url = "https://github.com/Monynha-Softwares/facodi.pt"
+  weight = 10

config/_default/menus/menus.fr.toml

@@ -0,0 +1,9 @@
+[[main]]
+  name = "Cours"
+  url = "/"
+  weight = 10
+
+[[footer]]
+  name = "Communauté"
+  url = "https://github.com/Monynha-Softwares/facodi.pt"
+  weight = 10

config/_default/params.toml

@@ -63,10 +63,6 @@ mainSections = ["courses"]
 
   krokiURL = "https://kroki.io"
 
-[supabase]
-  url = ""
-  anon_key = ""
-
 [seo]
   [seo.title]
     separator = " | "

content/en/_index.md

@@ -1,7 +1,8 @@
 ---
 title: "FACODI Catalog"
 layout: home
-draft: true
+draft: false
+lead: "Open academic catalog curated by the FACODI community."
 ---
 
-FACODI content is primarily authored in Portuguese. English translations will be published as they become available.
+FACODI content is primarily authored in Portuguese. English translations will be published as they become available. Subscribe to the community updates to know when new translations launch.

content/es/_index.md

@@ -0,0 +1,8 @@
+---
+title: "Catálogo FACODI"
+layout: home
+draft: false
+lead: "Catálogo académico abierto, impulsado por la comunidad FACODI."
+---
+
+El contenido completo está disponible primero en portugués. Las traducciones al español se publicarán de forma progresiva con el apoyo de la comunidad.

content/fr/_index.md

@@ -0,0 +1,8 @@
+---
+title: "Catalogue FACODI"
+layout: home
+draft: false
+lead: "Catalogue académique ouvert animé par la communauté FACODI."
+---
+
+Le catalogue FACODI est d'abord rédigé en portugais. Les traductions en français seront publiées progressivement avec l'aide de la communauté.

i18n/en.toml

@@ -0,0 +1,42 @@
+home_course_plan = { other = "Plan {{ .plan }}" }
+home_course_ects = { other = "{{ .ects }} ECTS" }
+home_course_semesters = { other = "{{ .count }} semesters" }
+home_course_summary_fallback = { other = "Documentation in progress." }
+home_no_courses = { other = "No courses published yet. Check back soon!" }
+
+course_header_label = { other = "Course {{ .code }}" }
+course_plan_label = { other = "Curriculum plan {{ .plan }}" }
+course_synced_title = { other = "Synced content" }
+course_synced_loading = { other = "Loading detailed description from Supabase…" }
+course_uc_title = { other = "Course units" }
+course_uc_loading = { other = "Loading course units…" }
+course_details_title = { other = "Course details" }
+course_details_institution = { other = "Institution" }
+course_details_school = { other = "School" }
+course_details_ects = { other = "ECTS" }
+course_details_duration = { other = "Duration" }
+course_details_language = { other = "Language" }
+
+uc_header_label = { other = "Course unit {{ .code }}" }
+uc_content_title = { other = "Official syllabus" }
+uc_content_loading = { other = "Syncing syllabus and materials…" }
+uc_outcomes_title = { other = "Learning outcomes" }
+uc_outcomes_loading = { other = "Loading outcomes…" }
+uc_playlists_title = { other = "Recommended playlists" }
+uc_playlists_loading = { other = "Loading playlists…" }
+uc_topics_title = { other = "Associated topics" }
+uc_topics_loading = { other = "Loading topics…" }
+uc_details_title = { other = "Information" }
+uc_details_course = { other = "Course" }
+uc_details_ects = { other = "ECTS" }
+uc_details_semester = { other = "Semester" }
+uc_details_language = { other = "Language" }
+uc_details_prerequisites = { other = "Prerequisites" }
+
+topic_header_label = { other = "Topic {{ .slug }}" }
+topic_content_title = { other = "Synced content" }
+topic_content_loading = { other = "Loading Markdown content…" }
+topic_playlists_title = { other = "Related playlists" }
+topic_playlists_loading = { other = "Loading playlists…" }
+topic_tags_title = { other = "Tags" }
+topic_tags_loading = { other = "Loading tags…" }

i18n/es.toml

@@ -0,0 +1,42 @@
+home_course_plan = { other = "Plan {{ .plan }}" }
+home_course_ects = { other = "{{ .ects }} ECTS" }
+home_course_semesters = { other = "{{ .count }} semestres" }
+home_course_summary_fallback = { other = "Documentación en preparación." }
+home_no_courses = { other = "Todavía no hay cursos publicados. ¡Vuelve pronto!" }
+
+course_header_label = { other = "Curso {{ .code }}" }
+course_plan_label = { other = "Plan curricular {{ .plan }}" }
+course_synced_title = { other = "Contenido sincronizado" }
+course_synced_loading = { other = "Cargando descripción detallada desde Supabase…" }
+course_uc_title = { other = "Asignaturas" }
+course_uc_loading = { other = "Cargando asignaturas…" }
+course_details_title = { other = "Detalles del curso" }
+course_details_institution = { other = "Institución" }
+course_details_school = { other = "Escuela" }
+course_details_ects = { other = "ECTS" }
+course_details_duration = { other = "Duración" }
+course_details_language = { other = "Idioma" }
+
+uc_header_label = { other = "Unidad curricular {{ .code }}" }
+uc_content_title = { other = "Plan oficial" }
+uc_content_loading = { other = "Sincronizando programa y materiales…" }
+uc_outcomes_title = { other = "Resultados de aprendizaje" }
+uc_outcomes_loading = { other = "Cargando resultados…" }
+uc_playlists_title = { other = "Listas recomendadas" }
+uc_playlists_loading = { other = "Cargando listas de reproducción…" }
+uc_topics_title = { other = "Temas asociados" }
+uc_topics_loading = { other = "Cargando temas…" }
+uc_details_title = { other = "Información" }
+uc_details_course = { other = "Curso" }
+uc_details_ects = { other = "ECTS" }
+uc_details_semester = { other = "Semestre" }
+uc_details_language = { other = "Idioma" }
+uc_details_prerequisites = { other = "Requisitos previos" }
+
+topic_header_label = { other = "Tema {{ .slug }}" }
+topic_content_title = { other = "Contenido sincronizado" }
+topic_content_loading = { other = "Cargando contenido Markdown…" }
+topic_playlists_title = { other = "Listas relacionadas" }
+topic_playlists_loading = { other = "Cargando listas de reproducción…" }
+topic_tags_title = { other = "Etiquetas" }
+topic_tags_loading = { other = "Cargando etiquetas…" }

i18n/fr.toml

@@ -0,0 +1,42 @@
+home_course_plan = { other = "Plan {{ .plan }}" }
+home_course_ects = { other = "{{ .ects }} ECTS" }
+home_course_semesters = { other = "{{ .count }} semestres" }
+home_course_summary_fallback = { other = "Documentation en préparation." }
+home_no_courses = { other = "Aucun cours publié pour le moment. Revenez bientôt !" }
+
+course_header_label = { other = "Cours {{ .code }}" }
+course_plan_label = { other = "Programme {{ .plan }}" }
+course_synced_title = { other = "Contenu synchronisé" }
+course_synced_loading = { other = "Chargement de la description détaillée depuis Supabase…" }
+course_uc_title = { other = "Unités curriculaires" }
+course_uc_loading = { other = "Chargement des unités curriculaires…" }
+course_details_title = { other = "Détails du cours" }
+course_details_institution = { other = "Institution" }
+course_details_school = { other = "École" }
+course_details_ects = { other = "ECTS" }
+course_details_duration = { other = "Durée" }
+course_details_language = { other = "Langue" }
+
+uc_header_label = { other = "Unité curriculaire {{ .code }}" }
+uc_content_title = { other = "Programme officiel" }
+uc_content_loading = { other = "Synchronisation du programme et des supports…" }
+uc_outcomes_title = { other = "Résultats d'apprentissage" }
+uc_outcomes_loading = { other = "Chargement des résultats…" }
+uc_playlists_title = { other = "Playlists recommandées" }
+uc_playlists_loading = { other = "Chargement des playlists…" }
+uc_topics_title = { other = "Sujets associés" }
+uc_topics_loading = { other = "Chargement des sujets…" }
+uc_details_title = { other = "Informations" }
+uc_details_course = { other = "Cours" }
+uc_details_ects = { other = "ECTS" }
+uc_details_semester = { other = "Semestre" }
+uc_details_language = { other = "Langue" }
+uc_details_prerequisites = { other = "Prérequis" }
+
+topic_header_label = { other = "Sujet {{ .slug }}" }
+topic_content_title = { other = "Contenu synchronisé" }
+topic_content_loading = { other = "Chargement du contenu Markdown…" }
+topic_playlists_title = { other = "Playlists associées" }
+topic_playlists_loading = { other = "Chargement des playlists…" }
+topic_tags_title = { other = "Étiquettes" }
+topic_tags_loading = { other = "Chargement des étiquettes…" }

i18n/pt.toml

@@ -0,0 +1,42 @@
+home_course_plan = { other = "Plano {{ .plan }}" }
+home_course_ects = { other = "{{ .ects }} ECTS" }
+home_course_semesters = { other = "{{ .count }} semestres" }
+home_course_summary_fallback = { other = "Documentação em preparação." }
+home_no_courses = { other = "Nenhum curso publicado ainda. Volte em breve!" }
+
+course_header_label = { other = "Curso {{ .code }}" }
+course_plan_label = { other = "Plano curricular {{ .plan }}" }
+course_synced_title = { other = "Conteúdo sincronizado" }
+course_synced_loading = { other = "Carregando descrição detalhada a partir do Supabase…" }
+course_uc_title = { other = "Unidades curriculares" }
+course_uc_loading = { other = "Carregando unidades curriculares…" }
+course_details_title = { other = "Detalhes do curso" }
+course_details_institution = { other = "Instituição" }
+course_details_school = { other = "Escola" }
+course_details_ects = { other = "ECTS" }
+course_details_duration = { other = "Duração" }
+course_details_language = { other = "Idioma" }
+
+uc_header_label = { other = "Unidade curricular {{ .code }}" }
+uc_content_title = { other = "Conteúdo oficial" }
+uc_content_loading = { other = "Sincronizando ementa e materiais…" }
+uc_outcomes_title = { other = "Resultados de aprendizagem" }
+uc_outcomes_loading = { other = "Carregando resultados…" }
+uc_playlists_title = { other = "Playlists recomendadas" }
+uc_playlists_loading = { other = "Carregando playlists…" }
+uc_topics_title = { other = "Tópicos associados" }
+uc_topics_loading = { other = "Carregando tópicos…" }
+uc_details_title = { other = "Informações" }
+uc_details_course = { other = "Curso" }
+uc_details_ects = { other = "ECTS" }
+uc_details_semester = { other = "Semestre" }
+uc_details_language = { other = "Idioma" }
+uc_details_prerequisites = { other = "Pré-requisitos" }
+
+topic_header_label = { other = "Tópico {{ .slug }}" }
+topic_content_title = { other = "Conteúdo sincronizado" }
+topic_content_loading = { other = "Carregando conteúdo Markdown…" }
+topic_playlists_title = { other = "Playlists relacionadas" }
+topic_playlists_loading = { other = "Carregando playlists…" }
+topic_tags_title = { other = "Etiquetas" }
+topic_tags_loading = { other = "Carregando tags…" }

layouts/_default/baseof.html

@@ -1,5 +1,6 @@
 <!doctype html>
-<html lang="{{ .Site.LanguageCode | default "pt" }}" data-bs-theme="{{ site.Params.doks.colorMode | default "auto" }}">
+{{- $langTag := .Language.Params.languageTag | default .Language.LanguageCode | default .Site.LanguageCode | default "pt" -}}
+<html lang="{{ $langTag }}" data-bs-theme="{{ site.Params.doks.colorMode | default "auto" }}">
   {{ partial "head/head" . }}
   {{ partial "head/body-class" . }}
   <body class="{{ delimit (.Scratch.Get "class") " " }}"{{ if eq site.Params.doks.scrollSpy true }} data-bs-spy="scroll" data-bs-target="#toc" data-bs-root-margin="0px 0px -60%" data-bs-smooth-scroll="true" tabindex="0"{{ end }}{{ block "body-attrs" . }}{{ end }}>

layouts/_partials/footer/script-footer-custom.html

@@ -1,5 +1,5 @@
-{{- $supabaseUrl := site.Params.supabase.url | default (getenv "SUPABASE_URL") -}}
-{{- $supabaseAnon := site.Params.supabase.anon_key | default (getenv "SUPABASE_ANON_KEY") -}}
+{{- $supabaseUrl := (getenv "SUPABASE_URL") | default "" -}}
+{{- $supabaseAnon := (getenv "SUPABASE_ANON_KEY") | default "" -}}
 <script>
   window.__SUPABASE_URL__ = "{{ $supabaseUrl }}";
   window.__SUPABASE_ANON_KEY__ = "{{ $supabaseAnon }}";