Git Product home page Git Product logo

julia-doc-pt_br's Introduction

A documentação pode ser visualizada online no ReadTheDocs!

README da tradução brasileira

Contribuindo

Contribuições são sempre bem-vindas, e podem ser feitas das seguintes maneiras, em ordem de praticidade:

  • Enviar um pull request diretamente aqui no GitHub. Isto pode ser feito automaticamente se você possuir uma conta no site, basta editar um arquivo e enviar.
  • Enviar um patch via diff ou git por e-mail em [email protected]
  • Enviar um arquivo inteiro traduzido no e-mail acima.

Recomendações

Para uniformizar e organizar a tradução, há algumas recomendações abaixo. Todas elas podem ser quebradas caso o bom senso mande, mas em geral é bom mantê-las para garantir um projeto fácil de ser cuidado e atualizado!

Linhas devem preferencialmente ter 71 caracteres ou menos, para facilitar a edição do texto nos mais variados programas e celulares/tablets. Se duas linhas estão em sequência, elas vão ser unidas no mesmo parágrafo automaticamente na documentação final.

Termos em língua estrangeira devem estar em itálico.

Na documentação existem alguns links para a Wikipédia inglesa. Esses links devem ser mantidos e adicionados os correspondentes na Wikipédia portuguesa, preferencialmente na forma de notas de rodapé.

Ao traduzir parte da documentação, preferencialmente utilize a lista, em ordem alfabética dos termos em inglês, a seguir para alguns termos técnicos que não possuem tradução para o português.

Inglês Português
API API
features características
departures características
environment ambiente
just-in-time just-in-time
multiple dispatch multiple dispatch
performance desempenho
prototyping experimentação
wrapper wrapper
string string
typing tipagem
tuple enupla (ou tupla?)
for loops loops for
hash table tabela de espalhamento (ou manter hash table?)

README da Documentação de Julia

A documentação de Julia está escrita em reStructuredText, e uma boa referência é o capítulo Documenting Python do Python Developer's Guide.

Compilando a documentação

A documentação é compilada usando o Sphinx e LaTeX. No Ubuntu, você precisa ter os seguintes pacotes instalados:

python-sphinx
texlive
texlive-latex-extra

E então rodar

$ make helpdb.jl
$ make html
$ make latexpdf

Estrutura dos arquivos

conf.py             Configuração do Sphinx
helpdb.jl           REPL help database
sphinx/             Extensões e plugins do Sphinx
sphinx/jlhelp.py    Plugin Sphinx para compilar helpdb.jl
stdlib/             Documentação da biblioteca padrão de Julia
_themes/            Temas html do Sphinx

julia-doc-pt_br's People

Contributors

andrioni avatar rgaiacs avatar wlbksy avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

julia-doc-pt_br's Issues

Mover para JuliaLangPt?

Olá @andrioni. Este projeto foi criado antes das iniciativas do @ismaelvc, mas neste momento já existe um projeto no Transifex para traduzir o site do Julia e eventualmente a documentação também. Até lá, acho que seria legal este repositório fazer parte da organização @JuliaLangPt. O que achas? Se concordares, o Ismael pode convidar-te para a organização (o que acho que devia ser feito de qualquer forma) e assim podes fazer a transferência do repositório.

Entendo se preferires manter na tua conta, claro.

Atualizar direto

Achar uma boa maneira de atualizar direto o texto em relação ao original em inglês.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.