220 lines
8.4 KiB
Markdown
220 lines
8.4 KiB
Markdown
# 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`
|
||
```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:
|
||
```sh
|
||
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`)
|
||
```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-garcia`
|
||
- `http://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)
|
||
```html
|
||
<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):
|
||
```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:
|
||
```md
|
||
# 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. 🚀
|