8.4 KiB
Workflow: Markdown → Gitea → HTTP + PDF
Aquest document explica com automatitzar la publicació d'informes d'orientació professional en un site estàtic, utilitzant Markdown, Gitea, hooks i generació de PDF.
1️⃣ Perfil Professional
1.1 Competència General dels Estudis
Aquest apartat detalla les habilitats i coneixements generals que proporciona cada cicle formatiu. Inclou la visió global del sector i com encaixa en el mercat laboral.
1.2 Competències Professionals, Personals i Socials
L'informe destaca les capacitats tècniques, la relació amb l'entorn de treball i les habilitats socials requerides.
1.3 Fitxes Ocupacionals
Llistat d’ocupacions associades a la formació, amb detalls sobre funcions, responsabilitats i requisits específics.
1.4 Anàlisi del Cicle Formatiu
- Accions Clau: Objectius acadèmics i professionals que defineixen el cicle.
- Mòduls Professionals: Detall dels continguts acadèmics.
- Unitats de Competència: Relació amb certificats professionals.
1.5 Anàlisi del Sector Professional
- Sortides Professionals: Camps d’inserció laboral.
- Relació d’Empreses de l’Entorn: Xarxa empresarial vinculada al sector.
- Competències Complementàries: Altres habilitats necessàries per destacar en el sector.
2️⃣ Àrea d'Autoconeixement
Es treballen aspectes com l’autoconeixement professional, identificació d’habilitats i adaptació als perfils laborals més adequats.
2.1 Eines d'Autoconeixement
Eines i metodologies per ajudar a l'usuari a comprendre les seves capacitats, motivacions i interessos professionals.
2.2 Autoavaluació de Capacitats Clau
Un procés de reflexió sobre les habilitats tècniques i personals en relació amb el mercat laboral.
2.3 Anàlisi Personal: DAFO
Es realitza un estudi de debilitats, amenaces, fortaleses i oportunitats per entendre millor el punt de partida i traçar estratègies de millora.
3️⃣ Projecció Professional
Plans d’orientació a curt, mitjà i llarg termini basats en les necessitats del mercat i les capacitats individuals.
3.1 Currículum Standard
Un model de currículum clàssic amb les dades bàsiques de l'usuari, experiència laboral, formació acadèmica i competències generals.
3.2 Currículum per Competències
Una versió del currículum que posa èmfasi en les habilitats adquirides, la capacitat de resolució de problemes i la polivalència de l’usuari en diferents entorns laborals.
3.3 Auto-Candidatura
Estratègies per presentar-se a empreses sense una oferta prèvia, destacant el valor professional de l'usuari i creant una proposta de valor per a l'empresa.
4️⃣ Coneixement del Mercat
4.1 Tastet Professionalitzador
Experiència pràctica en un entorn laboral real o simulat per ajudar a comprendre millor les demandes del sector professional.
4.2 Cròniques d'Experiències Professionals
Quatre relats detallats de situacions professionals viscudes, explicant els aprenentatges adquirits i les competències desenvolupades.
4.3 Altres Experiències que Amplien el Coneixement Professional
Aquest apartat recull experiències complementàries que ajuden a entendre millor el món laboral:
- Una lectura: Un llibre rellevant per a la formació i desenvolupament professional.
- Una activitat o joc: Experimentació d’habilitats a través de dinàmiques interactives.
- Una pel·lícula o sèrie: Un contingut audiovisual que ofereixi una perspectiva sobre el sector professional.
5️⃣ Itinerari Personal i Especialització
5.1 Més Formació després del Cicle Formatiu
Opcions per ampliar coneixements i millorar la qualificació professional després de completar el cicle formatiu.
5.2 On Trobar Feina
Recursos i estratègies per a la recerca activa d’ocupació en el sector d’interès.
5.3 Opcions d'Auto-Ocupació
Possibilitats d’emprenedoria i creació del propi negoci dins del sector.
5.4 Tres Possibles Sortides Laborals
- Curt Termini: Opcions immediates després del cicle.
- Mig Termini: Formació addicional i experiència professional per a millorar la posició.
- Llarg Termini: Especialització o direcció dins del sector.
5.5 Activitats/Treballs que He Realitzat que em Poden Ajudar a Saber el que Podria Fer
Reflexió sobre experiències prèvies que han ajudat a definir el camí professional.
5.6 Les Meves Pràctiques
- Lloc: Empresa o institució on s’han realitzat.
- Grup: Equip de treball i dinàmica interna.
- Aprenentatges fets: Coneixements i habilitats adquirides durant les pràctiques.
- Valoració: Experiència global i punts de millora.
Workflow: Markdown → Gitea → HTTP + PDF
Aquest document explica com automatitzar la publicació d'informes d'orientació professional en un site estàtic, utilitzant Markdown, Gitea, hooks i generació de PDF.
1️⃣ Escriu el contingut en Markdown
Crea els teus informes IPOP en .md i puja'ls a un repositori de Gitea.
Exemple de informe.md
# Informe Personal d’Orientació Professional
## Joan Garcia
- **Àrees professionals:** Enginyeria, Disseny Gràfic
- **Competències destacades:** Anàlisi, Creativitat, Resolució de Problemes
2️⃣ Puja els fitxers a Gitea
Executa:
git add informe.md
git commit -m "Afegit informe Joan Garcia"
git push origin main
3️⃣ Automatització amb Gitea Webhooks
Quan es detecta un canvi en el repo, un hook automàtic executa el generador de site estàtic.
Exemple de Hook (gitea-hooks.sh)
#!/bin/bash
cd /var/www/informes
git pull origin main
hugo -D # O jekyll build
systemctl restart nginx # Si cal refrescar el servidor
Configura el webhook a Gitea per executar aquest script.
4️⃣ Site estàtic accessible via HTTP
Ara el teu site està publicat automàticament en:
http://empresa.com/informes/joan-garciahttp://intranet/informes/
Frameworks recomanats:
- Hugo → Lleuger i ràpid
- Jekyll → Suporta directament Markdown
- Eleventy → Molt flexible
5️⃣ Generació de PDFs sota demanda
Opcions per a la generació de PDF:
✅ Opció 1: Client-side (JavaScript - jsPDF)
<button id="pdf">Descarrega PDF</button>
<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf/2.4.0/jspdf.umd.min.js"></script>
<script>
document.getElementById('pdf').addEventListener('click', function () {
var doc = new window.jspdf.jsPDF();
doc.text(document.body.innerText, 10, 10);
doc.save("informe.pdf");
});
</script>
✔️ No requereix backend, tot passa al navegador.
✅ Opció 2: Server-side (Puppeteer o Pandoc)
Generació amb Puppeteer (Node.js):
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch();
const page = await browser.newPage();
await page.goto('http://empresa.com/informes/joan-garcia', {waitUntil: 'networkidle2'});
await page.pdf({path: 'informe.pdf', format: 'A4'});
await browser.close();
})();
✔️ Millor formatació, però requereix configuració de servidor.
🔁 Flux del Workflow
Markdown (Gitea Repo) --> Webhook --> Site Estàtic (Hugo/Jekyll) --> Web HTML
\
--> API PDF (Puppeteer o jsPDF)
📌 Conclusió
✅ Automatitzat: git push i la web s'actualitza sola.
✅ Offline-ready: HTML navegable + PDFs generats sota demanda.
✅ Eficient i segur: Sense bases de dades, tot en fitxers.
📌 Workflow Detallat
Markdown → Gitea → HTTP + PDF
Aquest sistema permet escriure informes en Markdown, versionar-los a Gitea, i automàticament desplegar-los com una web estàtica amb opció de descarregar-los en PDF.
1️⃣ Escriu el contingut en Markdown
Cada informe es crea dins la carpeta content/informes/ com un fitxer Markdown:
# Informe Personal d’Orientació Professional
## Joan Garcia
- **Àrees professionals:** Enginyeria, Disseny Gràfic
- **Competències destacades:** Anàlisi, Creativitat, Resolució de Problemes
📌 Conclusió
✅ Automatitzat: git push i la web s'actualitza sola.
✅ Offline-ready: HTML navegable + PDFs generats sota demanda.
✅ Eficient i segur: Sense bases de dades, tot en fitxers.
Aquest sistema és perfecte per a centres educatius, institucions i empreses que necessiten informes professionals accessibles de manera senzilla i eficient. 🚀