Commit d7d90db3 authored by Marina Freitas's avatar Marina Freitas

Resultado do estudo de git. Problema: as listas ordenadas teimam e não se ordenar.

parent e4683ef2
......@@ -14,9 +14,20 @@ Também é possível utilizar [AsciiDoc](http://asciidoc.org/), entretando não
1. No Debian (TropOS) Instalar npm e calibre
* (O calibre contém o conversor de formato ebook-converter)
> $ sudo apt-get instal npm calibre
> $ sudo apt-get install npm calibre
1. Instalar GitBook
* Ver readme.md no [repositório oficial](https://github.com/GitbookIO/gitbook)
> $ npm install gitbook-cli -g
> $ sudo ln -s /usr/bin/nodejs /usr/bin/node
* Mais sobre o motivo para usar um [link simbólico](https://stackoverflow.com/questions/20886217/browserify-error-usr-bin-env-node-no-such-file-or-directory).
* Por fim, roda-se o gitbook com o comando:
> $ gitbook install
1. Instalar plugin katex para uso de equações matemáticas
* Instruções no [repositório do plugin](https://github.com/GitbookIO/plugin-katex)
* Lista de [funções implementadas no KaTeX](https://github.com/Khan/KaTeX/wiki/Function-Support-in-KaTeX)
......@@ -32,6 +43,46 @@ Cada gitbook deve conter ao menos dois arquivos, `README.md` e `SUMMARY.md`:
O arquivo `book.json` contém a configuração geral do livro. Neste exemplo o arquivo `book.json` foi alterado para remover icones indesejadas.
## Contribua no texto
Os passos para fazer uma contribuição ao texto são:
1. Clonar repositório
> $ git clone https://repositório
2. Abrir um ramo (branch)
> $ git branch meuramo
3. Ir para o ramo que criaste
> $ git checkout meuramo
4. Editar o texto usando seu editor de texto favorito e salvando as alterações. Para visualizar se o texto está com os marcadores corretos pra linguagem do gitbook, gere um html com:
> $ gitbook build
Uma pasta chamada "_book" será criada com o link do html.
5. Criar um commit
* Certifique-se de ter configurado seu nome e seu email para aparecer como autor do commit.
> $ git add nome_do_arquivo_que_foi_alterado.md
Altere apenas os arquivos .md. Não é necessário nem recomendado que inclua qualquer outra modificação no commit, como por exemplo o arquivo pdf e a versão HTML, caso as tenha gerado. Basta não dar git add nos outros arquivos.
> $ git commit -m "Comentário obrigatório"
6. Enviar o commit no novo ramo (branch) para o repositório
> $ git push origin meuramo
* O termo "origin" é determinado pelo dirigente do projeto, e pode ser diferente. Porém é o termo que é geralmente usado.
7. Fazer um pedido para fundir (merge request)
Selecionar a origem o seu ramo e o destino o ramo master
## Conheça o Git
......@@ -40,4 +91,11 @@ Alguns recursos:
* [Noções Básicas de Git - site oficial](https://git-scm.com/book/pt-br/v1/Primeiros-passos-No%C3%A7%C3%B5es-B%C3%A1sicas-de-Git)
* [Primeiros passos com Git - Centro de Tecnologia Acadêmica](http://cta.if.ufrgs.br/projects/suporte-cta/wiki/Git)
Para remover as configurações de usuário global, basta editar o arquivo ~/.gitconfig, aqui é onde todas as configurações globais são salvas. Pela linha de comando pode-se usar:
> $ git config --global --unset-all user.name
ou
> git config --global --replace-all user.name "New User Name"
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment