Help FreeCAD/pt-br: Difference between revisions
(Created page with "Veja a página Objectos gráficos e Directrizes para trabalhos gráficos para orientações sobre a criação de ícones para o FreeCAD.") |
(Created page with "Escrever código para o FreeCAD não é difícil e você não precisa de nenhuma permissão para isso. Você pode começar a trabalhar em algo de que precisa agora mesmo e env...") |
||
Line 69: | Line 69: | ||
== Programe! == |
== Programe! == |
||
Escrever código para o FreeCAD não é difícil e você não precisa de nenhuma permissão para isso. Você pode começar a trabalhar em algo de que precisa agora mesmo e enviá-lo como um ‘patch’ por meio do [http://www.freecadweb.org/tracker 'tracker'] ou solicitar sua integração a partir de um [https://github.com/FreeCAD 'branch' no git]. Para evitar dores de cabeça, primeiro você precisa aceitar os seguintes pré-requisitos: |
|||
* FreeCAD |
* O FreeCAD avança no seu próprio ritmo, e tem uma equipa muito pequena de programadores. Não temos todo o tempo que gostaríamos de gastar no FreeCAD, e nada está previamente planeado. O trabalho é feito quando um desenvolvedor encontra tempo para o fazer e sente que vale a pena. Não mantemos uma lista de afazeres. Cabe a todos encontrar algo que gostariam de fazer, por exemplo, um erro que gostariam de corrigir, ou uma pequena característica que pensam faltar. O [http://www.freecadweb.org/tracker tracker] também contém alguns tópicos que não são atribuídos a ninguém, e que estão à espera de um voluntário. |
||
* Antes de começar a codificar para o FreeCAD, é necessário estar familiarizado com o seu funcionamento. Parece óbvio, mas se não souber como funciona, não saberá o que tem que fazer internamente, ou como o fazer. |
|||
* Before you start to code for FreeCAD, you must know well how FreeCAD works. This seems obvious, but if you don't know how it is supposed to work you won't know what to do internally or how to do it. |
|||
* |
* Quase tudo pode ser feito em Python ou C++. As tarefas internas funcionam quase da mesma forma em ambas as línguas. Aconselhamos a leitura da página [[Power_users_hub|Documentação para usuários avançados]], mesmo que planeie programar em C++, pois dar-lhe-á uma boa visão geral do funcionamento interno. |
||
* |
* Se pretende trabalhar com C++, certifique-se de consegue compilar o FreeCAD sem problemas. |
||
* |
* Apresente-se a outros desenvolvedores. O FreeCAD é sobretudo um projeto colaborativo, discutimos muitas coisas no fórum antes de serem implementadas, e é melhor discutir as suas ideias e dizer aos outros o que está planejando antes de o fazer realmente. Também temos um [irc://chat.freenode.net/freecad canal IRC] que está sincronizado com o nosso canal [https://gitter.im/FreeCAD/FreeCAD gitter], mas o fórum é o único e único local onde todos os programadores se encontram. |
||
* |
* Desde 2016, o FreeCAD participa do [[Google_Summer_of_Code_2020|Google Summer of Code 2020]]. Não deixe de conferir nossas ideias aí se tiver interesse em participar da próxima edição. |
||
{{Userdocnavi{{#translation:}}}} |
{{Userdocnavi{{#translation:}}}} |
Revision as of 17:17, 22 June 2021
Introdução
Se gosta do FreeCAD e gostaria de ajudar no seu desenvolvimento, para além de doações, há muitas outras coisas que pode fazer, mesmo que não sendo um programador.
Trabalhe na documentação
Ajude-nos a construir, corrigir e ampliar esta documentação. Corrigir erros, estender ou corrigir páginas que não estejam claras, criar novas páginas se faltar um tópico, etc. Contribuir para o wiki do FreeCAD é fácil, em WikiPages você pode encontrar as diretrizes gerais e a ajuda necessária para começar.Para editar o wiki, você precisará de uma conta wiki com permissões de "Editor" (o wiki é protegido contra gravação para evitar spam). Pode solicitar uma conta fórum ou no IRC. Note que o canal do IRC pode não ser tão responsivo como o fórum. O fórum oficial do FreeCAD deve ser o local principal para fazer perguntas e iniciar discussões, pois ajudará a preservar a experiência e o conhecimento da comunidade.
Algumas áreas indicadas para iniciar o trabalho:
- A página Categoria:Referência de Comando lista e documenta todos os comandos do FreeCAD. A maioria deles contém pouca ou nenhuma informação. Por favor, consulte WikiPages para bons exemplos de como devem ser as páginas de documentação de comandos.
- A seção Tutoriais precisa de exemplos sobre como utilizar as bancadas de trabalho. Se desenvolveu algo interessante com o FreeCAD, porque não documentar como o fez para a posteridade?
- Existem entradas pendentes no rastreador de erros marcadas como "documentation" use com amor.
Partilhe o seu conhecimento do FreeCAD
A comunidade de usuários em torno do FreeCAD ainda é pequena, mas já inclui vários usuários avançados que fazem um trabalho muito importante para mostrar aos recém-chegados como utilizar o ‘software’. Se começar a sentir-se confortável com o FreeCAD, os seus conhecimentos poderão ser muito valiosos para outros, e poderá contribuir com recursos importantes como, por exemplo:
- Mostrando o trabalho que fez com o FreeCAD no fórum 'Users Showcase forum'. Pode colocar capturas de tela e melhor ainda se anexar os arquivos do FreeCAD, para que outras pessoas possam examiná-lo e compreender como foi feito.
- Gravar vídeos mostrando como fez algo interessante no FreeCAD. Estes vídeos fazem normalmente um excelente trabalho mostrando novas funcionalidades.
- Escrever tutoriais descrevendo ou ensinando algo interessante. Pode escrever tutoriais no seu próprio "blog", diretamente no nosso wiki, ou mesmo no fórum.
- Publique na rede social de código aberto Mastodon(e siga o FreeCAD lá) ou na comunidade do Facebook.
- Veja os últimos posts FreeCAD no Reddit, 3dprinting.stackexchange, StackOverflow... Tente responder e participe das discussões partilhando a sua experiência e informação.
- Participar do canal IRC FreeCAD ou outras salas de conversa.
Traduza o FreeCAD
Localize o FreeCAD para a sua língua. Todas as cadeias de texto da interface do FreeCAD podem ser facilmente traduzidas para outras línguas. Tudo o que precisamos é de alguém que saiba outras línguas e esteja disposto a ajudar! Todas as traduções são feitas online em Crowdin.
Para mais detalhes sobre a tradução, consulte Localização.
Traduza a documentação
Traduzir é fácil, o wiki FreeCAD suporta um "plugin" de tradução que lhe permite traduzir a página base em inglês para outras línguas.
Para detalhes sobre tradução, consulte Localização#Traduzindo o wiki do FreeCAD.
Por favor, certifique-se de que está familiarizado com os fundamentos de marcação wiki; ver Ajuda:Editando como referência.
Depois dirija-se a PáginasWiki para se familiarizar com o estilo utilizado neste wiki, particularmente quando se trata de modelos.
Ajudar os outros a conhecer o FreeCAD
- Fale sobre o FreeCAD a outras pessoas que possam ter interesse.
- Se encontrar usos interessantes para o FreeCAD, documente-os, usando capturas de tela como exemplo. O FreeCAD é bastante jovem, e muitas pessoas não imaginam o que se pode fazer com ele. Se já é um fã do FreeCAD, certamente sabe algo legal que o FreeCAD pode fazer. Ajude-nos a mostrar isso a outros!
- De uma passada no fórum e ajude os recém-chegados a resolver questões básicas.
- Escreva tutoriais, grave vídeos, etc., mostrando o que se pode fazer com o FreeCAD.
- Contribuir com arquivos, desenhos, etc. Ainda faltam bons arquivos de exemplo do que pode ser feito com o FreeCAD.
- Ajuda para promover o FreeCAD no GitHub dando "Estrela" e "Observando" o repositório FreeCAD
Reportar falhas e solicitar funcionalidades interessantes
Embora o local para relatar erros confirmados e sugerir novas funcionalidades seja eventualmente o FreeCAD Tracker, por favor, publique sempre primeiro os relatórios de erros e pedidos de funcionalidades no fórum. De modo a poupar tempo aos programadores (triagem e tratamento de erros difíceis de compreender podem ser muito demorados), e evitar frustrações porque o seu problema não foi tratado da forma que gostaria, por favor leia o seguinte:
- Erros e pedidos de funcionalidades são tratados no mesmo rastreador. Basta marcar o seu problema como "bug" (algo que não funciona como deveria) ou "feature" (algo que não está lá, mas que pensa que seria bom ter).
- Embora originalmente se pudesse submeter as questões anonimamente, infelizmente isto teve de ser cancelado devido ao spam. Agora, se desejar criar/editar bilhetes, terá de criar uma conta. Será então, por predefinição, notificado quando alguém acrescentar notas à questão. Em muitos casos, a pessoa que irá tratar do erro necessitará de mais informações da sua parte.
- Ao reportar um erro, o ponto mais importante é permitir que os desenvolvedores o reproduzam. Certifique-se de incluir os passos exatos necessários para que o erro aconteça, para que outra pessoa possa fazer o mesmo e ver o erro acontecer também na sua máquina. Se o desenvolvedor não conseguir visualizar o erro, também não poderá solucioná-lo.
- Inclua também informação que possa ajudar os desenvolvedores a situar o problema, como o sistema operacional em que executa o FreeCAD, a versão exata do FreeCAD e as bibliotecas relevantes. Por favor, publique todos os dados usando o botão "Copiar para Área de Transferência" na Ajuda(menu) → sobre o diálogo do FreeCAD, e faça-o a partir da bancada de trabalho Part ou PartDesign.
- Não importa o quão certo está de que encontrou um erro, por favor discuta sempre os erros primeiro no fórum.
- Antes de submeter um pedido de recurso, discuta-o sempre primeiro com outros usuários no fórum de discussão aberto, para que possa acabar com uma proposta mais concreta, com mais opções interessantes para um desenvolvedor implementar.
- Lembre-se que o FreeCAD é desenvolvido por voluntários que utilizam o seu tempo livre para trabalhar nele. Embora todos deem o seu melhor para fazer a melhor aplicação possível, o seu relatório de erro pode ser tratado com menos prioridade, ou cancelado se não tiver informação suficiente, e o seu pedido de recurso pode ser adiado ou mesmo recusado se nenhum desenvolvedor tiver interesse em implementá-lo ou se isso exigir uma quantidade anormal de trabalho.
Projeto artístico
Veja a página Objectos gráficos e Directrizes para trabalhos gráficos para orientações sobre a criação de ícones para o FreeCAD.
Programe!
Escrever código para o FreeCAD não é difícil e você não precisa de nenhuma permissão para isso. Você pode começar a trabalhar em algo de que precisa agora mesmo e enviá-lo como um ‘patch’ por meio do 'tracker' ou solicitar sua integração a partir de um 'branch' no git. Para evitar dores de cabeça, primeiro você precisa aceitar os seguintes pré-requisitos:
- O FreeCAD avança no seu próprio ritmo, e tem uma equipa muito pequena de programadores. Não temos todo o tempo que gostaríamos de gastar no FreeCAD, e nada está previamente planeado. O trabalho é feito quando um desenvolvedor encontra tempo para o fazer e sente que vale a pena. Não mantemos uma lista de afazeres. Cabe a todos encontrar algo que gostariam de fazer, por exemplo, um erro que gostariam de corrigir, ou uma pequena característica que pensam faltar. O tracker também contém alguns tópicos que não são atribuídos a ninguém, e que estão à espera de um voluntário.
- Antes de começar a codificar para o FreeCAD, é necessário estar familiarizado com o seu funcionamento. Parece óbvio, mas se não souber como funciona, não saberá o que tem que fazer internamente, ou como o fazer.
- Quase tudo pode ser feito em Python ou C++. As tarefas internas funcionam quase da mesma forma em ambas as línguas. Aconselhamos a leitura da página Documentação para usuários avançados, mesmo que planeie programar em C++, pois dar-lhe-á uma boa visão geral do funcionamento interno.
- Se pretende trabalhar com C++, certifique-se de consegue compilar o FreeCAD sem problemas.
- Apresente-se a outros desenvolvedores. O FreeCAD é sobretudo um projeto colaborativo, discutimos muitas coisas no fórum antes de serem implementadas, e é melhor discutir as suas ideias e dizer aos outros o que está planejando antes de o fazer realmente. Também temos um canal IRC que está sincronizado com o nosso canal gitter, mas o fórum é o único e único local onde todos os programadores se encontram.
- Desde 2016, o FreeCAD participa do Google Summer of Code 2020. Não deixe de conferir nossas ideias aí se tiver interesse em participar da próxima edição.
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub