Portfólio de Grupo — Prototipagem Digital¶

Este repositório é a entrega final do vosso grupo. Cada commit no main atualiza automaticamente a galeria pública do site da disciplina (~1-2 minutos).

Componentes da entrega¶

Tutorial Video (este foi criado para design de Produto, qq diferença está no passo a passo abaixo)¶

https://youtu.be/Q1UCXW5ldT4

0. Setup (todos os elementos do grupo)¶

Ferramentas¶

• GitHub Desktop — https://desktop.github.com
• Obsidian — https://obsidian.md

Conta GitHub¶

Cada elemento precisa de uma conta: https://github.com/signup.

1. Aceitar a tarefa e clonar o repositório¶

Um elemento do grupo (líder técnico) faz o seguinte:

1. Abre o link da tarefa: https://classroom.github.com/a/uxUUF3jN
2. Cria uma equipa com um nome curto (ex.: grupo-A). Os colegas juntam-se quando seguirem o link depois de ti.
3. Aceita a tarefa → cria-se um repositório de grupo.
4. No GitHub Desktop → File → Clone repository → escolhe o repositório recém-criado. Ou acendendo ao link, na página principal, no dropdown "CODE" a verde no canto sup direito, tens um "open in Github Desktop"

Os outros elementos aceitam o link e juntam-se à equipa criada (sem criar equipa nova).

2. Abrir como Obsidian Vault¶

1. Abrir Obsidian → Open folder as vault → escolher a pasta clonada (para saberes a sua localização, caso não a tenhas personalizado no passo anterior, carrega no botão direito no Github desktop sobre o nome do repositório clonado e "Reveal in Finder" ou Explorer (mac e windows respectivamente).
2. Pronto. O vault já está pré-configurado:
3. No entanto, verifica a pre-configuração. (se não, segue a do vídeo - é importante que esteja assim para funcionar)
4. Imagens arrastadas vão para attachments/ ao lado do documento.
5. Links em formato Markdown padrão (![](attachments/foto.jpg)), nunca em formato Wiki (![[foto.jpg]]).

As definições estão em Settings → Files & Links.

3. Fluxo sem conflitos de git¶

De qualquer forma não é complicado. basta que pensem que cada vez que querem contribuir para alguma coisa no vosso repositorio têm que perceber se alguém já o fez antes e garantir que versão (commit) no vosso computador é a mais atual. Assim, basta que repitam o "mantra": - Fetch content; - Pull (se aparecer disponivel); - commit (preenchendo antes o nome da versão- não precisa de ser nada elaborado, só para que se lembrem caso à frente queiram desfazer); - Push

Caso isto vos atrapalhe peçam ajuda. É algo fácil para nós ou se sentirem mesmo inseguro(a)s com este formato elejam um(a) líder técnico(a) como único(a) responsável por commits/pushes. Neste caso, os colegas entregam-lhe (email, drive), que copia para o repositório local, faz commit e push.

4. Estrutura do repositório¶

.
├── index.md                              # Página de grupo (Home)
├── tutoriais/
│   └── _modelo/                          # DUPLICAR para cada máquina (2 tutoriais)
│       ├── index.md                      # Tutorial detalhado
│       └── attachments/
├── experiencias/
│   └── _modelo/                          # DUPLICAR para cada elemento
│       ├── index.md                      # Projeto individual
│       └── attachments/
├── attachments/                          # Imagens partilhadas do grupo
└── README.md

O que preencher¶

A. Página de grupo (index.md)¶

Atualizem o frontmatter (linhas entre ---):

group_name: "Nome do Grupo"
group_number: "G01"
course: "PrototipagemDigital"
members:
  - number: "20231234"
    name: "Aluno A"
  - number: "20235678"
    name: "Aluno B"

Atualizem também a tabela de elementos, e a galeria de tutoriais e de experiências individuais.

B. Tutoriais (tutoriais/)¶

Para cada uma das duas máquinas:

1. Duplicar tutoriais/_modelo/ e renomear para tutoriais/<nome-da-maquina>/ (ex.: tutoriais/silhouette-cameo/).
2. Atualizar o frontmatter (title, hero_title, hero_subtitle, machine_name).
3. Preencher as 6 secções:
4. Como desenhar para esta tecnologia
5. Como preparar um ficheiro
6. Antes de Começar (Segurança + Ficheiros)
7. Como operar a máquina passo-a-passo
8. Resultado e pós-produção
9. Recursos e Ficheiros
10. Voltar ao index.md da raiz e atualizar o card correspondente (substituir _modelo em ambos os caminhos por <nome-da-maquina>).

Referência de estrutura: tutorial da CNC do Fablab Benfica — https://fablabbenfica.gitlab.io/fablabbenficadocs/machines/ouplan/.

C. Projetos individuais (experiencias/)¶

Cada elemento:

1. Duplicar experiencias/_modelo/ para experiencias/<numero>-<primeiro-nome>/ (ex.: experiencias/20231234-maria/).
2. Atualizar o frontmatter (title, hero_*, student_name, student_number).
3. Preencher as secções: Conceito, Tecnologias Usadas, Processo, Resultado Final, Reflexão.
4. Adicionar imagens bem produzidas do resultado final e do processo.
5. Atualizar a galeria de experiências no index.md da raiz com um card para o novo projeto.

5. Imagens — convenção¶

No corpo do texto¶

Arrastar para o Obsidian → guarda em attachments/ ao lado do documento → insere ![](attachments/foto.jpg) automaticamente. Funciona em qualquer ficheiro.

Imagem de capa (hero)¶

A hero tem de chamar-se sempre hero.jpg (ou hero.png), na pasta attachments/ ao lado do .md. Cada nível tem o seu próprio hero.jpg:

• attachments/hero.jpg ao lado de index.md → hero do grupo
• tutoriais/<máquina>/attachments/hero.jpg → hero do tutorial
• experiencias/<numero>-<nome>/attachments/hero.jpg → hero do projeto individual

Outras imagens podem ter qualquer nome — só a hero é que tem nome obrigatório.

Caminho no frontmatter¶

Vídeos e modelos 3D¶

O site converte automaticamente:

• ![](video.mp4) → vídeo embebido (também .webm, .mov, .ogg)
• ![](modelo.stl) → visualizador 3D (também .step, .obj, .glb, .gltf)
• Links https://a360.co/... → visualizador Autodesk
• Links bare de YouTube (https://youtu.be/...) → embed iframe

6. Commit e push¶

No GitHub Desktop:

1. Fetch content;
2. Pull (se aparecer disponível);
3. Ver alterações na coluna esquerda
4. Escrever uma mensagem curta no campo Summary
5. Commit to main
6. Push origin

Espera ~1-2 minutos. A galeria pública atualiza-se sozinha.

7. Privacidade¶

• published: false no index.md da raiz → grupo não aparece na galeria pública.
• published: false no index.md de um tutorial ou projeto individual → esse item não é listado.

8. Resolver problemas comuns¶