2.1. Tutoriais do Programming Historian#

As lições listadas abaixo são fundamentais para um bom aproveitamento do framework proposto nessa pesquisa. Elas apresentam noção básicas para utilização de linha de comando, Python, e Jupyter notebooks, além de apresentar métodos para a gestão de dados digitais, escrita e publicação de dados.

Os resumos foram retirados das próprias lições do site do Programming Historian.

Conhecimento computacional básico#

  1. Introduction to the Bash Command Line, Milligan and Baker [2014].

    • Tradução para o português em andamento. Ver aqui.

    • Resumo da lição: “Essa lição lhe ensinará como enviar comandos utilizando uma interface de linha de comando, ao invés de uma interface gráfica. Interfaces de linha de comando possuem vantagens para usuários de computador que precisam de maior precisão em seu trabalho, como historiadores(as) digitais. Permitem mais detalhamento ao rodar alguns programas, visto que você pode adicionar modificações para especificar exatamente como deseja que um programa seja executado. Além do mais, podem ser facilmente automatizados através de scripts, que são basicamente conjuntos de comandos baseados em texto.”

  2. Introdução e instalação do Python, Turkel and Crymble [2012].

    • Resumo da lição: “Essa primeira lição em nossa seção para tratar de Fontes Online é preparada para que você e o seu computador estejam prontos para se iniciarem na programação. Nós iremos nos concentrar em instalar os softwares necessários – todos livres e de boa reputação – e finalmente nós iremos te auxiliar a experimentar os primeiros passos na programação para que você tenha resultados imediatos.”

  3. Instalação de Módulos Python com pip, Gibbs [2013].

    • Resumo da lição: “Há muitas formas de se instalar bibliotecas externas de Python; esta lição explica um dos métodos mais comuns usando pip.”

  4. Introdução ao Jupyter Notebook, Dombrowski, Gniady, and Kloster [2019].

    • Resumo da lição: Jupyter Notebook fornece um ambiente onde você pode trabalhar com facilidade o seu código na linguagem Python. Esta lição descreve como instalar o software Jupyter Notebook, como executar e criar ficheiros para o Jupyter Notebook.”

  5. Introduction to the Windows Command Line with PowerShell, Dawson [2016].

    • Resumo da lição: “This tutorial will introduce you to the basics of Windows PowerShell, the standard command-line interface for Windows computers.”

Gestão de Dados#

  1. Preservar os seus dados de investigação, Baker [2021].

    • Resumo da lição: “Esta lição irá sugerir maneiras pelas quais os historiadores podem documentar e estruturar os seus dados de pesquisa, a fim de garantir que continuem sendo acessíveis no futuro.”

  2. Git como ferramenta metodológica em projetos de História (parte 1)[1], Eric Brasil [2023].

    • Resumo da lição: “A lição busca caracterizar sistemas de controle de versões, tendo o Git como exemplo, e analisar as possibilidades de seu uso para a pesquisa em História. Para tanto, pretende-se apresentar detalhadamente as principais funções e recursos do Git para o controle de versões localmente, desde a configuração inicial do programa até sua aplicação em um exemplo prático.”

Escrita e publicação#

  1. Introdução ao Markdown, Simpkin [2015].

    • Resumo da lição: “Nesta lição é apresentado o Markdown, uma sintaxe baseada em texto simples para formatação de documentos. É explicado porque ele é usado, como formatar ficheiros Markdown e como pré-visualizar documentos formatados em Markdown na web.”

  2. Autoria Sustentável em Texto Simples usando Pandoc e Markdown, Tenen and Wythoff [2014].

    • Resumo da lição: “Neste tutorial, você aprenderá primeiro o básico do Markdown - uma sintaxe de marcação fácil de ler e escrever para texto simples - bem como Pandoc, uma ferramenta de linha de comando que converte texto simples em vários tipos de ficheiros formatados: PDF, docx, HTML, LaTeX, apresentação de slides e muito mais.”

Referências#

[Bak21]

James Baker. Preservar os seus dados de investigação. The Programming Historian em português, January 2021. URL: https://programminghistorian.org/pt/licoes/preservar-os-seus-dados-de-investigacao (visited on 2021-05-12), doi:10.46430/phpt0001.

[Bra23]

Eric Brasil. Git como ferramenta metodológica em projetos de História (parte 1). 2023. doi:https://doi.org/10.46430/phpt0045.

[Daw16]

Ted Dawson. Introduction to the Windows Command Line with PowerShell. Programming Historian, July 2016. URL: https://programminghistorian.org/en/lessons/intro-to-powershell (visited on 2023-09-22).

[DGK19]

Quinn Dombrowski, Tassie Gniady, and David Kloster. Introdução ao Jupyter Notebook. Programming Historian, December 2019. URL: https://programminghistorian.org/pt/licoes/introducao-jupyter-notebooks (visited on 2023-09-13).

[Gib13]

Fred Gibbs. Instalação de Módulos Python com pip. Programming Historian, May 2013. URL: https://programminghistorian.org/pt/licoes/instalacao-modulos-python-pip (visited on 2023-09-13).

[MB14]

Ian Milligan and James Baker. Introduction to the Bash Command Line. Programming Historian, September 2014. URL: https://programminghistorian.org/en/lessons/intro-to-bash (visited on 2023-09-13).

[Sim15]

Sarah Simpkin. Introdução ao Markdown. Programming Historian, November 2015. URL: https://programminghistorian.org/pt/licoes/introducao-ao-markdown (visited on 2023-09-22).

[TW14]

Dennis Tenen and Grant Wythoff. Autoria Sustentável em Texto Simples usando Pandoc e Markdown. Programming Historian, March 2014. URL: https://programminghistorian.org/pt/licoes/autoria-sustentavel-texto-simples-pandoc-markdown (visited on 2023-09-22).

[TC12]

William J. Turkel and Adam Crymble. Introdução e instalação do Python. Programming Historian, July 2012. URL: https://programminghistorian.org/pt/licoes/introducao-instalacao-python (visited on 2023-09-22).