Expandindo a caixa de ferramentas digitais (parte 1)

Oficina 1 - Prof Eric Brasil

quarta-feira, 27 de agosto de 2025

Oficina de Ferramentas

Expandir a caixa de ferramentas digitais significa não apenas conhecer novos instrumentos, mas também refletir sobre como eles transformam o modo como produzimos, ensinamos e compartilhamos.

Ferramentas Digitais

• Bash
  
• PowerShell
  
• Tropy
  
• Zotero
  

• Omeka
  
• Obsidian
  
• Markdown
  
• MarkText
  
• Quarto
  

1. Terminal e Linha de Comando

• O terminal é a ponte direta entre você e o computador.
  
• Mais rápido, flexível e poderoso que interfaces gráficas.
  

Exemplos práticos: comandos básicos

Abra o terminal (Linux: Ctrl+Alt+T | Windows: Win+R → cmd ou powershell)

Exemplos práticos: comandos básicos

# criar pasta
mkdir projetos

# entrar na pasta
cd projetos

# listar arquivos
ls

# copiar arquivo
cp texto.txt copia.txt

# mover/renomear arquivo
mv copia.txt final.txt

# apagar arquivo
rm final.txt

Exemplos práticos: mover vários arquivos

# mover todos os arquivos .pdf da pasta atual para /destino
mv *.pdf /caminho/para/destino/

Exemplos práticos: criar vários arquivos numerados

# criar 5 arquivos de texto com nomes numerados no linux/bash
touch arquivo{1..5}.txt

Ferramentas CLI úteis

CLI = Command Line Interface (Interface de Linha de Comando)

Importante ter um gerenciador de pacotes instalado. No caso do Linux (Ubuntu/Debian), o apt já vem por padrão.

Para windows, recomendo instalar o scoop (https://scoop.sh/) para facilitar a instalação de ferramentas via terminal/powershell:

# instalar scoop
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Ferramentas CLI úteis

# 🔎 fzf → fuzzy finder (busca interativa)
ls | fzf

# 📊 btop → monitor de sistema
btop

# 📄 head / tail → ver primeiras/últimas linhas de um arquivo
head -n 10 arquivo.txt
tail -n 20 arquivo.txt

# ⚡ fastfetch → exibe informações do sistema
fastfetch

# 📂 dust → ver uso de disco (mais legível que du)
dust

2. Ferramentas para organização e gestão

2.1. Zotero

• O que é?
  Gerenciador gratuito e de código aberto para referências bibliográficas e materiais de pesquisa.

2.1. Zotero

• Por que usar?
  • Organiza referências e fontes em uma única biblioteca.
    
  • Gera citações e bibliografias automaticamente (variados estilos).
    
  • Sincroniza com a nuvem e permite colaboração em grupo.
    
  • Integra-se com editores de texto (Word, LibreOffice, Google Docs).

2.1. Zotero

• Links úteis
  • 🌐 Site oficial
    
  • 📥 Download
    
  • 📖 Documentação

💡 Importância: Dominar o Zotero significa ganhar tempo, padronização e reduzir erros na vida acadêmica.

2.2. Tropy

• O que é?
  Software gratuito e de código aberto para organizar e descrever fotografias de documentos de pesquisa.

2.2. Tropy

• Por que usar?
  • Ajuda a gerenciar grandes coleções de imagens de arquivos, bibliotecas e acervos.
    
  • Permite adicionar metadados, notas e transcrições a cada imagem.
    
  • Facilita a busca e categorização de documentos digitalizados.
    
  • Projetado especialmente para pesquisadores em humanidades.

2.2. Tropy

• Links úteis
  • 🌐 Site oficial
    
  • 📥 Download
    
  • 📖 Documentação

💡 Importância: O Tropy transforma imagens de documentos em um acervo pesquisável e organizado, evitando acúmulo caótico de fotos.

2.3. Omeka

• O que é?
  Plataforma de código aberto para criação de exposições virtuais e gestão de coleções digitais.

2.3. Omeka

• Por que usar?
  • Permite organizar, descrever e publicar acervos digitais.
    
  • Suporta metadados padronizados (Dublin Core).
    
  • Facilita a criação de exposições narrativas online.
    
  • Muito utilizada por museus, arquivos, bibliotecas e pesquisadores.

2.3. Omeka

• Links úteis
  • 🌐 Site oficial
    
  • 🖥️ Omeka Classic | Omeka S
    
  • 📖 Documentação

💡 Importância: O Omeka possibilita transformar pesquisas e acervos em exposições digitais acessíveis ao público, fortalecendo a História Pública.

3. Ferramentas para escrita e publicação

3.1. Markdown

• O que é?
  Linguagem de marcação leve e intuitiva para escrever textos estruturados que podem ser convertidos em HTML, PDF, slides, livros, etc.

3.1. Markdown

• Por que usar?
  • Simples de aprender: combina texto com alguns símbolos (#, *, >, etc.).
    
  • Mantém o foco no conteúdo e não na formatação.
    
  • É portável e duradouro, sem depender de softwares proprietários.
    
  • Base para ferramentas como Quarto, Jupyter, Obsidian, entre outras.

3.1. Markdown

• Links úteis
  • 🌐 Site oficial
    
  • 📖 Guia rápido
    
  • 🛠️ Editor online

💡 Importância: Aprender Markdown é como dominar um “canivete suíço” para a escrita acadêmica e digital.

Exemplos básicos de Markdown

# Título 1
## Título 2
### Título 3

**negrito**  
*itálico*  
~~riscado~~

Título 1

Título 2

Título 3

negrito
itálico
riscado

Exemplos básicos de Markdown

- Lista não ordenada
- Lista não ordenada
- Lista não ordenada
  - Subitem
  - Subitem
  - Subitem
- [ ] Tarefa não feita
- [x] Tarefa feita

Exemplos básicos de Markdown

• Lista não ordenada
• Lista não ordenada
• Lista não ordenada
  • Subitem
  • Subitem
  • Subitem
• Tarefa não feita
• Tarefa feita

Exemplos básicos de Markdown

1. Lista ordenada
2. Outro item
3. Mais um item
    1. Subitem
    2. Subitem
    3. Subitem
4. Último item

Exemplos básicos de Markdown

1. Lista ordenada
2. Outro item
3. Mais um item
   1. Subitem
   2. Subitem
   3. Subitem
4. Último item

Exemplos básicos de Markdown

[Link para o site do Zotero](https://zotero.org)

![Imagem exemplo](https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg)

Exemplos básicos de Markdown

Link para o site do Zotero

Imagem exemplo

Exemplos básicos de Markdown

> Citação em bloco

`código em linha`

```python
# bloco de código
print("Olá, História Digital!")

Exemplos básicos de Markdown

Citação em bloco

código em linha

# bloco de código
print("Olá, História Digital!")

3.2. Quarto

• O que é?
  Plataforma aberta e multiplataforma para publicação científica e técnica.
  Permite criar artigos, relatórios, livros, sites e apresentações a partir de arquivos Markdown.

3.2. Quarto

• Por que usar?
  • Exporta para PDF, HTML, Word, livros e slides.
    
  • Integra-se com R, Python, Julia e outros ambientes científicos.
    
  • Automatiza citações e bibliografias (via BibTeX/Zotero).
    
  • Favorece a reprodutibilidade e versionamento com Git/GitHub.

3.2. Quarto

• Instalação
  • Linux: sudo apt install quarto-cli
    
  • Windows: Download
• Dependências
  • Pandoc (já incluso no Quarto)
    
  • LaTeX (para gerar PDFs) → recomendado instalar TinyTeX

3.2. Quarto

• Exemplo de frontmatter (YAML)

---
title: "Meu Artigo Científico"
author: "Eric Brasil"
date: 2025-08-13
format: pdf
bibliography: referencias.bib
csl: abnt.csl   # estilo de citação
---

Pipeline básico com Quarto

1. Escreva o arquivo artigo.qmd
   • Use Markdown + YAML no início
2. Adicione referências
   • Arquivo referencias.bib
     
   • Estilo de citação (.csl) — ex.: ABNT

Pipeline básico com Quarto

3. Compile para PDF

   quarto render artigo.qmd --to pdf

4. Resultado

   • PDF formatado como artigo científico
   • Citações e bibliografia automáticas

Pipeline básico com Quarto

💡 Fluxo de trabalho simples: Escrever → Renderizar → Compartilhar

Quarto x Word

Elemento	📝 Quarto	📄 Word
Texto	Foco no conteúdo	Foco na edição visual
Referências	Automáticas (Zotero + BibTeX)	Manuais ou via plugins
Exportação	Múltiplos formatos	PDF/DOCX

Quarto x Word

Elemento	📝 Quarto	📄 Word
Reprodutibilidade	Sempre o mesmo resultado	Inconsistências
Versionamento	Fácil com Git	Difícil, arquivos binários
Colaboração	Via GitHub, controle total	Comentários, mas sem controle de versão real

Quarto x Word

Quarto não substitui totalmente o Word, mas é uma ferramenta poderosa para produção científica reprodutível e colaborativa.