Apresentações Ubuntu

Materiais em Markdown/Marp (e derivados HTML/PDF) sobre Ubuntu e software livre para diferentes públicos.

Estrutura

escolas/

Materiais para o contexto educativo.

• geral/ — série Ubuntu Desktop em cinco partes: ubuntu_apresentacao_1.md … ubuntu_apresentacao_5.md (decks Marp).
• professores/ — ubuntuDesktop_professores.md (e exportação HTML homónima) e conjunto FOSS para escolas: FOSS_escolas.md (e HTML exportado).
• direcao/ — materiais para direções de agrupamento: ubuntuDesktop.md e FOSS_Escolas.md.

empresas/

Materiais para empresas e contexto profissional.

• FOSS_Empresas_ODET_sala — fonte Markdown, exportações HTML e PDF.
• Textos de apoio: infraestrutura_oss_PME.md, infraestrutura_empresarial_linux.md, administracao_operacoes.md, formacao_carreira.md.

Ficheiros na raiz

• LICENSE — licenciamento do repositório.
• README.md — este ficheiro.

Uso

Os ficheiros .md com cabeçalho marp: true destinam-se ao Marp (pré-visualização e exportação para PDF/HTML). As pastas incluem também .html e .pdf onde já foram gerados a partir desses decks.

Exportação com @marp-team/marp-cli

1. Instalar o CLI (uma vez). Opções:

   • npm global:

     npm install -g @marp-team/marp-cli

   • npx sem instalar globalmente (substitui marp por npx @marp-team/marp-cli nos comandos abaixo).

   • Standalone binary (binário único com Node.js incluído — não precisa de instalar Node.js): descarregar o arquivo adequado ao sistema na página de releases do Marp CLI (marp-cli-*-linux.tar.gz, *-linux-arm64, *-mac.tar.gz ou *-win.zip). Extrair o arquivo; dentro está o executável marp. No Linux/macOS, pode ser necessário chmod +x marp. Coloque o executável num directório no seu PATH (por exemplo ~/.local/bin) ou invoque-o pelo caminho completo.
     Nota: o binário standalone não carrega configurações ou motores em ES Module; para esse cenário, prefira a instalação via Node.js ou npm (ver README do projeto).

2. Gerar HTML a partir de um deck (modelo Bespoke, adequado para apresentar no navegador):

   marp caminho/para/deck.md -o caminho/para/deck.html --html --no-stdin

   A flag --no-stdin evita que o Marp fique à espera de dados vindos do stdin quando corre em scripts ou pipelines.

3. Gerar PDF:

   marp caminho/para/deck.md -o caminho/para/deck.pdf --pdf --no-stdin

   A exportação PDF usa um browser headless (por exemplo Chrome ou Chromium). Se falhar, instale um destes browsers ou defina --browser-path com o caminho para o executável.

   Opções úteis para enriquecer o PDF:

   • --pdf-notes — Adiciona anotações de notas ao PDF no canto inferior esquerdo quando a página do slide tem notas do apresentador Marpit (comentários <!-- --> ou blocos de notas no Markdown).
   • --pdf-outlines — Adiciona ao PDF marcadores / índice (outlines / bookmarks) para navegação entre slides no leitor de PDF.

Exemplo a partir da raiz deste repositório:

marp escolas/geral/ubuntu_apresentacao_1.md \
  -o escolas/geral/ubuntu_apresentacao_1.html --html --no-stdin

marp escolas/geral/ubuntu_apresentacao_1.md \
  -o escolas/geral/ubuntu_apresentacao_1.pdf --pdf --no-stdin