Skip to content

Latest commit

 

History

History
81 lines (56 loc) · 3.18 KB

index.md

File metadata and controls

81 lines (56 loc) · 3.18 KB
Raw
title layout nav_order
Inicio
home
1

Logo da F&MD

Contribuindo

Instalando o Jekyll

sudo apt-get install ruby-full build-essential zlib1g-dev

Para zsh, adicione ao .zshrc:

mkdir "~/.gems"
echo '# Install Ruby Gems to ~/gems' >> ~/.zshrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.zshrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Para bash (terminal normal), adicione ao .bashrc:

mkdir "~/.gems"
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Instale o bundler:

gem install jekyll bundler

Agora vamos até o diretório do projeto e subimos o servidor:

cd /caminho/do/projeto
bundle exec jekyll serve --livereload

This is a bare-minimum template to create a Jekyll site that uses the Just the Docs theme. You can easily set the created site to be published on GitHub Pages – the README file explains how to do that, along with other details.

If Jekyll is installed on your computer, you can also build and preview the created site locally. This lets you test changes before committing them, and avoids waiting for GitHub Pages.1 And you will be able to deploy your local build to a different platform than GitHub Pages.

More specifically, the created site:

  • uses a gem-based approach, i.e. uses a Gemfile and loads the just-the-docs gem
  • uses the GitHub Pages / Actions workflow to build and publish the site on GitHub Pages

Other than that, you're free to customize sites that you create with this template, however you like. You can easily change the versions of just-the-docs and Jekyll it uses, as well as adding further plugins.

Browse our documentation to learn more about how to use this theme.

To get started with creating a site, simply:

  1. click "use this template" to create a GitHub repository
  2. go to Settings > Pages > Build and deployment > Source, and select GitHub Actions

If you want to maintain your docs in the docs directory of an existing project repo, see Hosting your docs from an existing project repo in the template README.

Footnotes

  1. It can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub. ↩