Pular para o conteúdo principal

Introdução

Seja bem vindo ao tutorial de como criar um site utilizando o Docusaurus. Vou mostrar o que tive que fazer para deixar o site com a aparência que você está vendo agora.

Requisitos​

Os principais recursos utilizados foram:

Você não precisa dominar todos esses recursos, mas não se preocupe, vou explicar o que é cada um deles e por que foi utilizado. Vamos começar!

Caso queira pular para algum tópico específico, clique nos links abaixo:

Git​

O Git é um sistema de controle de versão distribuído, ou seja, ele permite que você tenha um histórico de alterações em um projeto, e que você possa voltar para qualquer versão desse projeto. Ele também permite que você trabalhe em conjunto com outras pessoas em um mesmo projeto, e que você possa ver as alterações que elas fizeram.

Para instalar o Git, basta acessar o site oficial e baixar o instalador para o seu sistema operacional. Após a instalação, você pode abrir o terminal do seu sistema operacional e digitar o comando git --version para verificar se o Git foi instalado corretamente.

Github​

O Github é uma plataforma de hospedagem de código-fonte, ou seja, você pode hospedar seus projetos lá, e também pode hospedar projetos de outras pessoas. Ele também permite que você trabalhe em conjunto com outras pessoas em um mesmo projeto, e que você possa ver as alterações que elas fizeram.

Então você utiliza o Git para controlar as versões do seu projeto, e o Github para hospedar o seu projeto. É muito importante que você saiba essa diferença, pois muitas pessoas confundem os dois.

É importante que você tenha uma conta no GitHub, caso você ainda não tenha uma conta no Github, você pode criar uma clicando aqui.

Github Pages​

O Github Pages é um serviço de hospedagem de sites estáticos, ou seja, você pode hospedar um site estático no Github Pages. Um site estático é um site que não possui nenhum tipo de interação com o usuário, ou seja, ele não possui um backend, e não possui nenhum tipo de banco de dados. Ele é composto apenas por arquivos estáticos, como HTML, CSS, JavaScript, imagens, etc.

Markdown​

O Markdown é uma linguagem de marcação, ou seja, é uma linguagem que permite que você escreva textos formatados. Ele é muito utilizado para escrever documentações, pois ele permite que você escreva textos formatados de forma simples e rápida.

O Markdown é uma linguagem muito simples, e você pode aprender a utilizá-la em poucos minutos. Para aprender a utilizá-la, você pode acessar o site oficial, ou você pode acessar o tutorial do Markdown.

Docusaurus​

Agora que você já sabe o que é o Git, o Github, o Github Pages, o Markdown, e o que é um site estático, vamos falar sobre o Docusaurus.

O Docusaurus é um gerador de sites estáticos, ou seja, ele permite que você crie um site estático utilizando apenas o terminal do seu sistema operacional. Ele é muito utilizado para criar documentações, pois ele permite que você crie documentações de forma simples e rápida.

Node.js​

Para utilizar o Docusaurus, você precisa ter o Node.js instalado no seu computador. O Node.js é um ambiente de execução de JavaScript, ou seja, ele permite que você execute códigos JavaScript no seu computador.

Para instalar o Node.js, basta acessar o site oficial e baixar o instalador para o seu sistema operacional. Após a instalação, você pode abrir o terminal do seu sistema operacional e digitar o comando node --version para verificar se o Node.js foi instalado corretamente.

Visual Studio Code​

O Visual Studio Code é um editor de texto, ou seja, ele permite que você edite arquivos de texto. Ele é muito utilizado para editar arquivos de texto, pois ele possui muitos recursos que facilitam a edição de arquivos de texto.

Para esse tutorial, você pode utilizar qualquer editor de texto, eu utilizei o Visual Studio Code, pois ele é o editor de texto que eu mais utilizo.

Criando o projeto​

Agora que você já sabe o que é o Git, o Github, o Github Pages, o Markdown, o Docusaurus, o Node.js, e o Visual Studio Code, vamos criar o nosso projeto.