Instalando o mkdocs no MacOS¶

Este artigo apresenta uma das várias formas de se instalar o MkDocs no MacOS, neste caso, iniciaremos o processo utilizando o HomeBrew para instalar o python3 e o pip3

O HomeBrew funciona como o apt do Debian Linux, mas para o MacOS. Ele facilita a instalação do aplicativos sejam eles baseados em terminal ou em GUI.

Atualizando o HomeBrew¶

Antes de iniciarmos o processo de instalação do mkdocs vamos atualizar s lista de pacotes do HomeBrew, assim como iremos atualizar todos os pacotes instalados.

Para realizar as atualizações podemos utilizar os comandos abaixo. Como a quantidade de atualizações pode ser grande estes comandos podem demorar um pouco para serem concluidos. Para ajudar a acompanhar o processo, estamos utilizando a opção -v (verbose), ela faz com que o HomeBrew informe todos os passos que forem sendo executados, assim como o processo de atualização dos pacotes.

brew -v update
brew -v upgrade

Verificando a versão instalada do python¶

Antes de instalar o python, vamos verificar qual é a versão atualmente disponível no repositório.

brew info python

Caso o pacote não esteja instalado será apresentada uma mensagem semelhante à:

    python: stable 3.7.7 (bottled), HEAD
    Interpreted, interactive, object-oriented programming language
    https://www.python.org/
    Not installed

Caso haja algum pacote instalado a mesagem gerada deve ser semelhante à:

python: stable 3.7.7 (bottled), HEAD
Interpreted, interactive, object-oriented programming language
https://www.python.org/
/usr/local/Cellar/python/3.7.7 (4,006 files, 61.2MB) *
  Poured from bottle on 2020-06-17 at 11:35:25

Observe que na mensagem acima aparece a data em que a aplicação foi instalada (Derramada da Garrafa): Poured from bottle on 2020-06-17 at 11:35:25

Instalando o python¶

Para realizar a instalação do python, devemos utilizar o comando abaixo:

brew install -v python

Podemos verificar se a aplicação foi instalada utilizando o comando abaixo:

brew info python

Que deve gerar uma saída semelhante à:

python: stable 3.7.7 (bottled), HEAD
Interpreted, interactive, object-oriented programming language
https://www.python.org/
/usr/local/Cellar/python/3.7.7 (4,006 files, 61MB) *
    Poured from bottle on 2020-06-10 at 13:33:40

Verificando a instalação do pip3¶

Com o python instalado podemos passar para a instalação do pip3. O pip é um gerenciados de pacotes usado para instalar e gerenciar pacotes escritos em python. Assim como o python o pip possui duas versões, a versão 2 para os pacotes escritos em python2, nesta versão o comando recebe o nome de pip. Para os pacotes do python3 temos o pip3.

Para verificar onde o pip3 está instalado podemos utilziar o seguinte comando:

$ which pip3
    /usr/local/bin/pip3

Como podemos percebr o pip3 foi instalado no directório /usr/local/bin/.

Criando os alias¶

Para facilitar o uso do python3 e do pip3, adicionaremos ao arquivo ~/.bash_profile dois alias. Assim precisamos editar este arquivo:

nano ~/.bash_profile

E adicioanr as seguintes linhas

    alias python=/usr/local/bin/python3
    alias pip=/usr/local/bin/pip3

Para carregar estes novos ailas podemos utilizar o comando abaixo:

source ~/.bash_profile

Podemos verificar se os alias forram carregados utilizando o comando abaixo:

$alias | grep /usr
  alias mtr='sudo /usr/local/sbin/mtr'
  alias pip='/usr/local/bin/pip3'
  alias python='/usr/local/bin/python3'

Autualizando o pip¶

Antes de prosseguirmos vamos nos certificar que o pip está atualziando. Logo, podemos utilizar o seguinte comando:

pip -v install --upgrade pip

Utilizando a opção -v (verbose) conseguimos acompanhar todo o processo de atualização.

Instalando das dependencias do MkDocs¶

Apesar de não ser uma dependencia para a instalação do mkdocs o pacote matplotlib pode ser util em alguns sites. Logo, utilizaremos o comando abaixo para instala-lo:

pip install matplotlib