Introdução ao Onbording - V5

content/Teste.md

@@ -0,0 +1,9 @@
+---
+title: Exemplo Genérico
+tags:
+  - trilha/extras
+  - nivel/basico
+---
+
+
+![[Pasted image 20251031203901.png]]

content/trilhas/04-extras/2025-s2/guia-hub.md

@@ -5,38 +5,44 @@ title: Onboarding do Hub – Guia passo a passo
 >
 >Isso aqui é um Tutorial direcionado apenas para os Membros da FEA.dev
 
+>[!info]
+>Os passos de 1 a 3 serão feitos uma **única vez**. Caso já tenha feito, você pode pular diretamente para o passo 4 em diante
+>
+>Se quiser aprender ou revisar a sintaxe da linguagem do Markdown acesse esse outro arquivo [colocar o caminho aqui]
+
 Este guia ensina qualquer pessoa a **acessar, editar e publicar** o Hub hospedado no **GitHub da organização** usando **Obsidian + Git + Quartz**.
 
 ## 1) O que você vai precisar (pré‑requisitos)
 
 - **Acesso ao repositório** da organização (peça para te adicionarem como _member_ e com permissão de escrita no repo do Hub).
     
-- Ter o **Git** instalado na sua máquina.
+- Ter o **Git e VsCode** instalados na sua máquina.
+    
+- Ter também o **Obsidian** instalado (para editar os arquivos Markdown `.md`)
     
-- Ter também o **Obsidian** instalado (para editar os arquivos Markdown `.md`).
 
 >[!info]
 > Links oficiais para download, caso ainda não tenha instalado:
 >
 > - [Git](https://git-scm.com)
+> - [VsCode](https://code.visualstudio.com/)
 > - [Obsidian](https://obsidian.md/)
 
-
 ## 2) Clonar o repositório da organização
 
 Com ambos instalados no seu computador, siga os seguintes passos:
 
-1 - Abra seu VsCode;
+1- Abra seu VsCode;
 
-2 - Inicialize seu Terminal, pode tanto arrastando com mouse a parte inferior para cima (imagem abaixo como referência) ou por meio do atalho Ctrl + Shift + Aspas;
+2- Inicialize seu Terminal, pode tanto arrastando com mouse a parte inferior para cima (imagem abaixo como referência) ou por meio do atalho Ctrl + Shift + Aspas;
 
 ![[guia-hub-2.jpg]]
 
-3 - É esperado que você esteja visualizando isso na  sua tela:
+3- É esperado que você esteja visualizando isso na  sua tela:
 
 ![[guia-hub-1.jpg]]
 
-4 - No terminal agora você vai clonar o repositório do github para sua máquina, por meio do git. Dessa forma: 
+4- No terminal agora você vai clonar o repositório do github para sua máquina, por meio do git. Dessa forma: 
 
 ```powershell
 # Alterar depois para os links corretos
@@ -47,31 +53,165 @@ cd <REPO-DO-HUB>
 git branch -a # o output aqui esperado algo que contenha 'v4'
 ```
 
-5 - Pronto é esperado que você tenha uma pasta com os arquivos do hub na máquina;
+5- Pronto é esperado que você tenha uma pasta com os arquivos do hub na máquina;
 
-6 - Para visualizar ela no seu computador, você deve fazer isso (ainda no terminal do VsCode):
+6- Para visualizar ela no seu computador, você deve fazer isso (ainda no terminal do VsCode):
 
 ```powershell
 explorer . # isso abre a pasta com os arquivos
 code . # isso abre a pasta no VsCode
 ```
 
-7 - Por enquanto no Vscode é isso, voltaremos para ele depois.
+7- Por enquanto no Vscode é isso, voltaremos para ele depois.
 
 ## 3) Partindo para o Obsidian
 
-1 -  Abra o Obsidian;
+1-  Abra o Obsidian;
 
-2 - No canto inferior esquerdo clique no "Vault" padrão que está no seu Obsidian (está ao lado do símbolo de interrogação e da engrenagem):
+2- No canto inferior esquerdo clique no "Vault" padrão que está no seu Obsidian (está ao lado do símbolo de interrogação e da engrenagem):
 
 ![[guia-hub-3.jpg]]
 
-3 - Após clicar nele, selecione em "Gerenciar Cofres...";
+3- Após clicar nele, selecione em "Gerenciar Cofres...";
 
 ![[guia-hub-4.jpg]]
 
-4 - Nessa nova tela que se abriu, clique em "Abrir" na seção "Abrir pasta como cofre"; 
+4- Nessa nova tela que se abriu, clique em "Abrir" na seção "Abrir pasta como cofre"; 
 
 ![[guia-hub-5.jpg]]
-5-
 
+5- No explorador de arquivos, você vai colocar o caminho que você encontrou no passo 2.6
+Você vai escrever na área de busca, algo parecido com isso:
+
+>[!warning]
+>Trocar essa imagem quando eu for trocar o nome do repositório para o da dev 
+
+
+![[guia-hub-6.jpg]]
+
+6- Seguindo a imagem, a pasta que deve estar selecionada é a 'content'. Com isso, você vai estar vendo que o nosso hub dentro do Obsidian (ele servirá como local de apenas de criar mudanças,  se quiser utilizar para leitura de preferência a utilizar o site). 
+
+7- A Cara do Hub é essa à princípio (imagem do dia 31/10/2025, no futuro poderá estar diferente):
+
+![[guia-hub-7.jpg]]
+
+## 4) Estrutura do Hub: 
+
+### Estrutura do Hub:
+
+a. Home Page: O arquivo referente a nossa página é o index (que não está em nenhuma pasta), à princípio a sua alteração fica a cargo apenas para o pessoal de Tech e da Gestão, não altera ele sem a permissão do pessoal. 
+
+![[guia-hub-8.jpg]]
+
+
+>[!warning]
+>**NÃO RENOMEIE NENHUM ARQUIVO CHAMADO INDEX, ESSE NOME FAZ QUE O QUARTZ RECONHEÇA COMO PÁGINA PRINCIPAL.**
+
+b. Trilhas: É a pasta que as 4 subpastas das nossas áreas de estudo
+
+c. Subpastas: Estão organizadas pelas áreas de Finquant, IA, Ciência de dados e Extras. Decorrente a cada área mãe, os arquivos estão organizado por ano e semestre. Serão nelas que vocês irão colocar seus projetos.
+
+d. Imagens: Logicamente é a pasta que vai conter as imagens que vocês vão anexar em seus arquivos. **É muito importante ela estar organizada**, **SEMPRE** coloque a imagem que vai usar **DENTRO DELA** e **NÃO** apenas cole no seu texto (o Obsidian vai fazer uma bagunça danada se apenas colar). Na próxima seção eu explico a razão.
+## 4) Criando seu arquivo e pasta:
+
+>[!info]
+Aqui eu vou te ensinar como criar seu arquivo e como organizá-lo aqui dentro do hub. As personalizações referentes a sintaxe do Markdown está no arquivo [colocar o arquivo aqui] e te convido a não se limitar apenas a ela, faça suas pesquisas em outras fontes!
+
+1- Criando arquivo genérico: Na barra lateral no canto superior direito clique no ícone com uma "folha e um lápis" chamado "Nova nota" e pronto vai ter seu arquivo criado. O nome que você colocar nele não importa tanto (o nome que aparecerá no site vai vir de uma personalização dentro dele, confie em mim!) coloque algo intuitivo e siga o mesmo padrão dos já existentes. 
+
+OBS: não utilize ponto no nome do arquivo ( por exemplo: cluster.portfólio, utilize cluster-portfólio ), o ponto faz que o Obsidian tente o ler como arquivo, no caso citado seria um arquivo .portfolio e não como Markdown.
+
+![[guia-hub-9.jpg]]
+
+2- Criando pasta: Bom para criar é só clicar no ícone da "pasta com um sinal mais dentro" está do lado do ícone do arquivo. As mesma recomendações do Arquivo valem para as Pastas.
+
+![[guia-hub-10.jpg]]
+
+3- Forma alternativa para ambos é só clicar com o botão direito na lateral
+
+![[guia-hub-11.jpg]]
+
+
+## 5) Personalização Essencial de sua Página:
+
+Com a sua primeira página criada, vamos dar um cabeçalho para ela e anexar as tags que vão aparecer lá no site. Para isso siga o seguinte instrução:
+
+1- Cabeçalho: Escreva exatamente três hífens (---) sem os parêntases no topo do arquivo, bem abaixo do título: 
+
+![[guia-hub-12.jpg]]
+vai aparecer isso exatamente na hora!
+
+2- Título: preencha essa propriedade com 'title' e escrava seu título que quiser
+
+![[guia-hub-13.jpg]]
+3- Tags: para adicionar uma tag clique em 'Adicionar propriedade' e escreva 'tags'. Até o momento temos 2 tipos de tags e com suas classificações:
+
+a- Nível:  escreva  #nivel/basico , #nivel/intermediario ou #nivel/avancado  
+
+b- Trilhas: escreva #trilha/finquant , #trilha/ia , #trilha/extras ou #trilha/ciencia-de-dados 
+
+Pronto seu cabeçalho está pronto, ficará dessa forma: 
+
+![[guia-hub-14.jpg]]
+
+## 6) Adicionar imagens
+
+Como já avisei anteriormente as imagens são algo que demandam bastante atenção aqui no Obsidian. Siga esses passos para deixar o ambiente organizado e funcional para todos:
+
+1- Crie uma subpasta na pasta imagem para armazenar suas imagens dentro, nesse exemplo criei uma que se chama "guia-hub":
+
+![[guia-hub-15.jpg]]
+
+2- Observe que todas as imagens que usei nesse arquivo estão dentro dela, tente manter a mesma sintaxe vai te ajudar a selecioná-las depois; 
+
+ ![[guia-hub-16.jpg]]
+
+3- Você pode salvar a imagem dando um Ctrl + V da imagem dentro da imagem e depois  a renomeando apertando com o botão direito do mouse ou você pode fazer seu manejo pelo explorador de arquivos fique tranquilo
+
+4- Com isso em mente, para você colocar a sua imagem no corpo do seu arquivo faça a seguinte sintaxe: 
+
+![[guia-hub-17.jpg]]
+
+Dessa forma, já aparecerá uma sugestão para adicionar uma imagem salva no obsidian.
+
+5- Referenciando a imagem que você quer, terá algo do tipo:
+
+![[guia-hub-18.jpg]]
+
+6- Pronto sua imagem foi indexada ao Texto.
+
+OBS: Você se deve estar se perguntando todo esse trabalho para criar uma imagem somente, não seria mais fácil color e pronto? 
+Eu concordo com você, seria muito mais fácil e direto, mas vou te mostrar o problemão que isso ai dar! 
+
+se eu simplesmente colasse a imagem que eu queria aconteceria isso: 
+
+![[guia-hub-19.jpg]]
+O nome da imagem seria algo bem abstrato e que depois para saber o que aquela imagem queria mostrar e de qual projeto faz parte. Além disso, ao se fazer isso o Obsidian adiociona automaticamente a imagem na barra lateral de forma aleatória! Observe na imagem que anexei abaixo: 
+
+![[guia-hub-20.jpg]] 
+
+**Por fim eu sei que é um processo chato, mas que a longo prazo é necessário para a própria manutenção da organização do hub. Com pouco tempo você já acostuma com a sintaxe e já sai quase de forma automática. Conto com vocês com essa parte!**
+
+## 7) Mandando seu arquivo para o Github e para o Hub
+
+Bom espero que esteja acompanhando tudo até o momento, supunha que terminou as alterações no seu arquivo e já quer mandar ele para o Github. Para isso siga esses passo:
+
+1- Volte para o VsCode
+ 
+2- Mude para o ambiente da o hub;
+
+![[guia-hub-21.jpg]]
+
+3- adicione o que você alterou na pasta content
+
+
+
+ 
+
+## [Opcional] - Background do Hub:
+
+>[!info]
+>Se ainda ficou curiso e quer saber como o Hub foi feito e entender mais o como funciona o Quartz, leia a seguinte documentação: 
+>[https://quartz.jzhao.xyz/authoring-content](https://quartz.jzhao.xyz/authoring-content)
+[https://notes.nicolevanderhoeven.com/How+to+publish+Obsidian+notes+with+Quartz+on+GitHub+Pages](https://notes.nicolevanderhoeven.com/How+to+publish+Obsidian+notes+with+Quartz+on+GitHub+Pages)
+>[https://yagasaki.bohr.io/blog/como-criar-um-blog-usando-github-pages-obsidian-quartz](https://yagasaki.bohr.io/blog/como-criar-um-blog-usando-github-pages-obsidian-quartz)