Jekyll no Fedora - Instalação e utilização
O Jekyll é um gerador de sites estáticos, com reconhecimento de blog, para sites pessoais, de projetos ou de organizações, com suporte ao GitHub.
Instalação do Jekyll
[root@amd64 ~]$ dnf group install "Development Tools"
[root@amd64 ~]$ dnf install ruby ruby-devel rpm-build
Agora execute os seguintes comandos com o seu user
[pratajo@amd64 ~]$ echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
[pratajo@amd64 ~]$ echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
[pratajo@amd64 ~]$ echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
[pratajo@amd64 ~]$ source ~/.bashrc
Finalmente instale Jekyll
[pratajo@amd64 ~]$ gem install jekyll bundler
Crie uma pasta (nome ao seu gosto) com o site Jekyll, entre na pasta e construa o site
[pratajo@amd64 ~]$ jekyll new meusite
[pratajo@amd64 ~]$ cd meusite
[pratajo@amd64 meusite]$ bundle exec jekyll serve
Abra o navegador em http://localhost:4000
O tema instalado por defeito: minima
Hospedar um site no GitHub Pages
Crie um repositório vazio no GitHub Pages no formato xxxx.girhub.io
No site edite _config.yml e escreva o nome do repositório "xxxx" criado no Git. Inicialize o repositório Git e sincronize o site.
baseurl: "xxxx.github.io"
[pratajo@amd64 meusite]$ git init
[pratajo@amd64 meusite]$ git checkout -b master
[pratajo@amd64 meusite]$ git status
[pratajo@amd64 meusite]$ git add .
[pratajo@amd64 meusite]$ git config --global user.email "eu@exemplo.com"
[pratajo@amd64 meusite]$ git config --global user.name "Meu Nome"
[pratajo@amd64 meusite]$ git commit -m "Commit inicial"
[pratajo@amd64 meusite]$ git remote add origin https://github.com/yyyyy/xxxx.github.io.git
Ao fazer o upload do site, serão pedidos o username e a password do GitHub.
[pratajo@amd64 meusite]$ git push -u origin master
Clonar localmente um site do GitHub Pages
Após a criação do site no GitHub podemos clonar o site localmente. Para isso vá à pasta onde pretende armazenar o projeto e clone o novo repositório.
[pratajo@amd64 Site]$ git clone https://github.com/username/username.github.io
Após alterar um ficheiro, por exemplo index.html, envie esta nova versão para o GitHub
[pratajo@amd64 Site]$ cd username.github.io
[pratajo@amd64 username.github.io]$ git add index.html (se for um novo ficheiro)
[pratajo@amd64 username.github.io]$ git commit index.html -m “Initial commit”
[pratajo@amd64 username.github.io]$ git push origin master
E temos o site em https://username.github.io :)