Ajuda, recursos e dicas¶
Nós fizemos o nosso melhor para tornar simples PY4WEB e limpo. Mas você sabe, moderno programação web é uma tarefa difícil. Ela exige uma mente aberta, capaz de saltar com frequência (sem ser perdida!) De python para HTML para javascript para css e gestão de banco de dados mesmo. Mas não tenha medo, neste manual vamos ajudá-lo lado a lado nesta jornada. E há muitos outros recursos valiosos que nós vamos mostrar-lhe.
Recursos¶
Este manual¶
Este manual é o Manual de Referência para py4web. Está disponível on-line em https://py4web.com/_documentation/static/index.html, onde você também encontrará o PDF e versão e-book, em vários idiomas. Ele foi originalmente escrito com o formato MarkMin (semelhante ao MarkDown) e exibidas em HTML com uma aplicação py4web personalizado. Em 2020, decidiu converter suas fontes para o formato RST que é mais adequado para documentação técnica. Usando Esfinge eo estilo ReadTheDocs agora somos capazes de alcançar resultados de alta qualidade.
O grupo Google¶
Existe uma lista de discussão dedicado hospedado no Google Groups, consulte https://groups.google.com/g/py4web. Esta é a principal fonte de discussões para desenvolvedores e usuários simples. Para qualquer problema que você deve enfrentar, este é o lugar certo para procurar uma dica ou uma solução.
O bate-papo no IRC¶
Nós também usamos para conversar em algum momento no IRC (Internet Relay Chat, que é um texto de estilo antigo única chat). Você pode se juntar a nós livremente no https://webchat.freenode.net/#py4web. De vez em quando nós também usá-lo para hospedar um bate-papo pública agendada, onde você pode escrever e ler perguntas ao vivo para os desenvolvedores. Transcrições deles são, então, disponível na lista de discussão.
Tutoriais e vídeo¶
There are many tutorials and videos if you like them. Generally, you can search for them on YouTube.
Here are some of them:
the free video course by Luca de Alfaro at UC Santa Cruz.
the py4web blog app by Andrew Gavgavian, which uses py4web to replicate the famous Corey Schafer’s tutorial series on creating a blog app in Django
As fontes no GitHub¶
Last but not least, py4web is Open Source, with a BSD v3 licence, hosted on GitHub at https://github.com/web2py/py4web. This means that you can read, study and experiment with all of its internal details by yourself.
Dicas e sugestões¶
Este parágrafo é dedicado a dicas preliminares, sugestões e dicas que podem ser úteis para saber antes de começar a aprender py4web.
Pré-requisitos¶
A fim de compreender py4web você precisa de pelo menos um conhecimento básico python. Há muitos livros, cursos e tutoriais disponíveis na Web - escolher o que é melhor para você. decoradores do Python, em particular, são um marco de qualquer quadro python web e você tem que compreendê-lo totalmente.
Um local de trabalho python moderna¶
Nos capítulos seguintes, você vai começar a codificar em seu computador. Sugerimos que você configurar um moderno local de trabalho python se você pretende fazê-lo de forma eficiente e segura. Mesmo para a execução de exemplos simples e experimentar um pouco, sugerimos usar um ** Ambiente de Desenvolvimento Integrado ** (IDE). Isso fará com que a sua experiência de programação muito melhor, permitindo verificação de sintaxe, linting e depuração visual. Hoje em dia, existem dois principais escolhas livres e multiplataforma: Microsoft Visual Código Estúdio aka VScode <https://code.visualstudio.com/> __ e JetBrains PyCharm <https://www.jetbrains.com/pycharm/> __.
Quando você vai começar a lidar com programas mais complexos e confiabilidade necessidade, sugerimos também para:
usar ambientes virtuais (também chamado ** virtualenv **, veja aqui <https://docs.python.org/3.7/tutorial/venv.html> __ para uma introdução). Em um ambiente de trabalho complexo isso vai evitar a ser confuso com outros programas Python e módulos
usar um Concurrent Versions System (CVS ** **). Manter o controle de mudanças do seu programa é muito valioso - juntamente com backups que vai salvar sua vida computação! Git e GitHub são os padrões atuais.
Depuração py4web com VScode¶
In order to run py4web.py directly, you need to add "args": ["run", "apps"]
to the vscode launch.json configuration file.
In addition, if you should get gevent errors you have to add "gevent": true
on the same configuration file.
Depuração py4web com PyCharm¶
In PyCharm, if you should get gevent errors you need to enable Settings | Build, Execution, Deployment | Python Debugger | Gevent compatible.
Como contribuir¶
Precisamos da ajuda de todos: apoiar os nossos esforços! Você pode apenas partecipate no grupo Google tentando responder a outras das perguntas, enviar bugs usando ou criar pedidos puxe o repositório GitHub.
Se você deseja corrigir e ampliar este manual, ou mesmo traduzi-lo em uma nova língua estrangeira, você pode ler todas as informações necessárias diretamente no `README específica <https://github.com/web2py/py4web/blob/master/ docs / README.md> `__ no GitHub.
It’s really simple! Just change the .RST files in the /doc folder and create a Push Request on the GitHub repository at https://github.com/web2py/py4web - you can even do it within your browser. Once the PR is accepted, your changes will be written on the master branch, and will be reflected on the web pages / pdf / epub at the next output generation on the branch.