Base de conhecimento NDST (IFPB-PRPIPG)

Esta é nossa base de conhecimento. Abaixo você entenderá como contribuir para esta base de conhecimento.

IMPORTANTE

Não utilize apt-get para instalar pacotes Ruby, Gems ou Rails tanto no Debian como no Ubuntu. Este sistema está desatualizado e pode gerar dores de cabeça.

O método de instalação a seguir cria uma espécie de sandbox na sua home em: ~/.rvm. O que garante um ambiente mais isolado.

Requerimentos/Instalação [Debian/Ubuntu]

• Do sistema operacional
• Do ambiente
  • RVM - Ruby Version Manager
  • Ruby
  • Bundler - Gerenaciar as gems do projeto
• Do projeto
  • Gemfile - Gems do projeto

RVM

# Chave para segurar os Repositórios
$ gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB

# RVM
$ curl -sSL https://get.rvm.io | bash -s stable

# Ative o ambiente (Não precisa fazer toda vez)
$ source /home/$USER/.rvm/scripts/rvm

# Verifique a instalação / Resultado
$ rvm -v
# returns: rvm 1.29.3 (latest) by Michal Papis, Piotr Kuczynski, Wayne E. Seguin [https://rvm.io]

Outras opções de instalação disponíveis aqui.

Ruby

# Instale o Ruby através do RVM
$ rvm install ruby-2.5.0

# Garanta que está utilizando a versão correta
$ rvm use 2.5.0
# returns: Using /home/user/.rvm/gems/ruby-2.5.0

Bundler

O bundler tem como objetivo gerenciar as gems da sua aplicação. Para fazer a sua instalação:

$ gem install bundler

Gemfile

Agora que temos o bundler no nosso ambiente de trabalho podemos instalar todas as dependências do projeto. Dentro deste repositório existe um Gemfile, agora basta executar:

$ cd IFPB-PRPIPG.github.io/
$ bundler install

Rodando o ambiente

$ jekyll serve --watch

Criando novo post

$ ./initpost.sh -c Título da postagem

Mais detalhes aqui.

Requerimentos (Windows)

Aguardando contribuição...

Existe a possibilidade de instalar através desse executável: Ruby Installer
Escolha a versão 2.5.0 do ruby.

Requerimentos Docker

• Instale o docker para seu S.O.: Instruções

IMPORTANTE: A reconstrução só funciona corretamente no Linux. Windows não consegue sincronizar os arquivos automaticamente. É necessário reiniciar o container manualmente.

# Copie o repositório
$ git clone https://github.com/IFPB-PRPIPG/IFPB-PRPIPG.github.io

# Acesse a pasta
$ cd IFPB-PRPIPG.github.io

# Rode o container (Diretamente do repositório DOCKER da NDST)
$ docker run -it --rm -p 4000:4000 -v ${PWD}:/app ndst/bdc:stable

Explicação dos comandos

• Execução do container
  • -it : interativo
  • --rm : ao concluir a execução remove o container
  • -p : porta 80 localhost para 80 do container
  • -v : Volume que aguarda o caminho absoluto do código no host, seguido de dois pontos, caminho absoluto no container