Esse repositório contém o site do Programa de Ampliação e Consolidação de Tecnologias e Inovação no Contexto Educacional (PRACTICE) da Universidade Federal da Fronteira Sul, disponível em practice.uffs.cc
Link para o site oficial: https://practice.uffs.cc/
Dúvidas gerais: Envie um e-mail para [email protected]
Para testar o site localmente na sua máquina, você precisa ter algumas ferramentas instaladas que dependem do sistema operacional em uso. Siga os guias abaixo conforme o seu sistema operacional.
Você precisa ter o git instalado e um editor de código qualquer, ex.: Visual Studio Code, disponíveis. Se você estiver usando Windows 10, é recomendado utilizar o Windows Subsystem for Linux para rodar o site.
IMPORTANTE: se você está no Windows 10, pule para a seção 2. Linux (Ubuntu) e siga as instruções dessa seção. Se estiver usando Windows 8, 7 ou inferior, continue lendo as seções abaixo.
Instale a última versão do Ruby através do RubyInstaller. Baixe uma das versões Ruby+Devkit disponíveis, como o rubyinstaller-devkit-2.6.3-1-x64.exe, rode, e no último passo do instalador, escolha ridk install (para instalar gems com extensões nativas).
O site é construído com base no Jekyll que usa o bundler para gerenciar dependencias. Abra um terminal novo (para garantir que o PATH está atualizado depois de instalar o Ruby), e rode:
gem install bundler
Você precisa ter o git e um editor de código qualquer, ex.: Visual Studio Code, disponíveis:
sudo apt install git
Instale a última versão do Ruby:
sudo apt install ruby-full build-essential zlib1g-dev
A partir desse ponto, não é recomendado a utilização de uma conta root. Use a sua própria conta de usuário.
Primeiramente, configure o ambiente para a instalação do Ruby Gems:
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
Exporte o GEM_HOME:
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
Adicione o GEM_HOME ao PATH:
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
Carregue as novas configurações para o terminal:
source ~/.bashrc
O site é construído com base no Jekyll, que usa o bundler para gerenciar dependencias.
gem install bundler
sudo apt install ruby-bundler
Se você seguiu os pré-requisitos de instalação, a partir desse ponto você pode testar o site localmente na sua máquina. Siga os passos abaixo para
Faça fork do repositório do site pelo Github.
Clone o seu fork em uma pasta qualquer da sua máquina, e.x: c:\ ou `/tmp/:
git clone https://github.com/SEU_USUARIO/website-programa.git && cd website-programa
Acessando o clone via terminal então instale todas as dependências:
cd src
bundle update
Antes de fazer qualquer alteração no site, lembre-se do Guia para a equipe de desenvolvimento.
Para testar o site, entre na pasta onde você clonou esse repositório, e rode:
bundle exec jekyll serve
Após alguns segundos, o site estará disponível através da URL http://127.0.0.1:4000. Depois de rodar o comando, você deve ver algo similar ao seguinte:
Configuration file: /mnt/c/website-programa/_config.yml
Source: /mnt/c/website-programa
Destination: /mnt/c/website-programa/_site
Incremental build: disabled. Enable with --incremental
Generating...
done in 6.255 seconds.
Auto-regeneration may not work on some Windows versions.
Please see: https://github.com/Microsoft/BashOnWindows/issues/216
If it does not work, please upgrade Bash on Windows or run Jekyll with --no-watch.
Auto-regeneration: enabled for '/mnt/c/website-programa'
Server address: http://127.0.0.1:4000
Server running... press ctrl-c to stop.
Para colocar o site em produção, o conteúdo da pasta _site deve ser colocada em algum servidor web. Para gerar uma versão atualizada dela, rode o seguinte comando (dentro da pasta src do projeto).
bundle exec jekyll build
A partir daqui, o conteúdo da pasta _site está pronto para uso.
Esse projeto é licenciado nos termos da licença open-source Apache 2.0 e está disponível de graça.
Todas as alterações importantes no site são relatadas no arquivo CHANGELOG.md.