From 3b3e310f44c1211f162c84d1280ec9d004a4e26c Mon Sep 17 00:00:00 2001 From: "J. Rodolfo" Date: Sun, 22 Oct 2017 22:49:03 -0200 Subject: [PATCH 1/7] 'Project' and 'What is PyBee' tabs translated to pt_BR --- content/b/contents+pt.lr | 9 ++ content/bee/contents+pt.lr | 9 ++ content/community/contents+pt.lr | 10 +- content/community/related/contents+pt.lr | 37 +++++++ content/project/about/contents+pt.lr | 133 +++++++++++++++++++++++ content/project/contents+pt.lr | 17 +++ content/project/overview/contents+pt.lr | 44 ++++++++ 7 files changed, 255 insertions(+), 4 deletions(-) create mode 100644 content/b/contents+pt.lr create mode 100644 content/bee/contents+pt.lr create mode 100644 content/community/related/contents+pt.lr create mode 100644 content/project/about/contents+pt.lr create mode 100644 content/project/contents+pt.lr create mode 100644 content/project/overview/contents+pt.lr diff --git a/content/b/contents+pt.lr b/content/b/contents+pt.lr new file mode 100644 index 0000000..afa8c9d --- /dev/null +++ b/content/b/contents+pt.lr @@ -0,0 +1,9 @@ +_model: page +--- +title: Atalhos +--- +hide_from_index: no +--- +_discoverable: no +--- +_hidden: no diff --git a/content/bee/contents+pt.lr b/content/bee/contents+pt.lr new file mode 100644 index 0000000..afa8c9d --- /dev/null +++ b/content/bee/contents+pt.lr @@ -0,0 +1,9 @@ +_model: page +--- +title: Atalhos +--- +hide_from_index: no +--- +_discoverable: no +--- +_hidden: no diff --git a/content/community/contents+pt.lr b/content/community/contents+pt.lr index 6a20edd..cf1e660 100644 --- a/content/community/contents+pt.lr +++ b/content/community/contents+pt.lr @@ -1,7 +1,9 @@ -_template: community.html +_model: members --- -sort_key: 3 +title: Membros --- -summary: Este é um mundo pequeno, apesar de tudo... +sort_key: 6 --- -title: Comunidade +summary: Membros fazem o mundo girar. +--- +body: BeeWare não seria possível sem o apoio - financeiro e moral - das seguintes companhias e indivíduos. Toda comunidade BeeWare agradece por esse epoio. Por que não `se tornar um(a) membro(a) do projeto BeeWare você mesmo(a)? `__ diff --git a/content/community/related/contents+pt.lr b/content/community/related/contents+pt.lr new file mode 100644 index 0000000..a2f2fa4 --- /dev/null +++ b/content/community/related/contents+pt.lr @@ -0,0 +1,37 @@ +_model: page +--- +title: Projetos relacionados +--- +sort_key: 7 +--- +summary: Porque, às vezes, outras pessoas tem boas ideias (uma percepção chocante, sabemos!) +--- +body: + +O conjunto de projetos BeeWare não surgiu do nada. Existe um número de projetos que utilizamos como base e somos humildes em reconhecer que estamos em pé sobre os ombros desses gigantes. + +CookieCutter +----------------- + +`CookieCutter `__ é uma ferramenta de linha de comando que cria projetos a partir de cookiecutters (templates de project), por ex.: criando um projeto de pacote Python a partir de um template de projeto de pacote Python. + + +Django +----------- +`Django `__, um framework web para perfeccionistas com prazos apertados. + +Lektor +------------- + +Esse site foi criado usando `Lektor `__, um poderoso e flexível sistema de gerenciador de conteúdo (CMS) para construir belos e complexos sites a partir de arquivos estáticos — para pessoas que não querem escolher entre um CMS e uma ferramenta de blog estático. + + +check-manifest +--------------------- + +Você é uma pessoa que desenvolve em Python? Você alguma vez carregou pacotes para o Python Package Index (PIP)? Por acidente, já carregou pacotes quebrados com alguns arquivos faltando? Se sim, `check-manifest `__ é para você. + +octohatrack +----------------- + +Todas as contribuições contam, não apenas código. `octohatrack `__ permite que você veja todas as pessoas que contribuíram para um repositório GitHub, não apenas quem GitHub diz que são 'contribuidores'. Também disponível em um `brilhante website `__. diff --git a/content/project/about/contents+pt.lr b/content/project/about/contents+pt.lr new file mode 100644 index 0000000..0818199 --- /dev/null +++ b/content/project/about/contents+pt.lr @@ -0,0 +1,133 @@ +body: + +History +======= + +The BeeWare project started with a simple question: Why aren't the tools that we use as Python developers improving at the same rate as the rest of the technology we use on a daily basis? + +Python has proven itself as a highly capable language - approachable for newcomers, but powerful in the hands of experts. Python is rapidly becoming a major part of the data analysis, scientific computing, and web development landscape. And initiatives like `Django Girls`_ have demonstrated that using Python, it is possible to provide a 1-day training courses that introducing people with no programming experience to Python; and at the end of a day, attendees have developed and deployed a database-backed dynamic website, deployed to a publicly visible server. + +.. _Django Girls: https://djangogirls.org/ + +However, the developer experience for someone writing Python sometimes reflects more of the early 90's than the new millennium. The default development environment for Python is still an 80x25 console window. For users who have come from a Windows or Apple environment, where they're used to highly detailed, well designed graphical interfaces, this 30 year flashback can be a completely alien experience. + +And, yes, there are IDEs (Integrated Development Environments) that provide a native application experience for writing code. But those tools require you to adopt, wholesale, the IDE's way of looking at a project. They often introduce as many headaches to the development process as they solve. + +And so, we're left with an interesting schism, between the "old way" of Unix development in a console window, and the "new way" of all-in-one IDEs. + +The Unix Philosophy +~~~~~~~~~~~~~~~~~~~ + +However, it doesn't have to be that way. The core tenet of the Unix Philosophy is that "each tool does one thing, well". This is a very powerful philosophy, and it enables the composition of extremely powerful toolchains by putting together a suite of extremely focussed, independent tools. + +Unfortunately, most UNIX tools have convolved this to also mean "all tools must use a console interface". However, there's nothing in the UNIX philosophy that says that tools have to use a console interface - it's just turned out that way. + +The BeeWare project started with the premise we can have the best of both worlds. We can have a chain of composable tools that each do one thing, well. But those tools can also expose their functionality using a rich graphical user interface. + +The goal +======== + +The end goal of the BeeWare project: To be able to do for mobile and desktop user-facing software the same thing that Django has done for web software - to put into the hands of users a set of tools and libraries that enables them to develop rich, native user interfaces, and deploy them to their devices. This includes: + + * Tools to enable Python to run on different devices, + * Tools to package a Python project so it can run on those devices, + * Libraries to access the native widgets and capabilities of devices, + * Tools to help develop, debug, analyze and these projects. + +This aim is that this set of tools will be easy enough to use for complete newcomers to use in a Django Girls-like setting; but powerful enough that they could be used to drive the next Instagram, Pinterest or Disqus. + +Most importantly, it aims to do all this as an Open Source community. The Open Source development process has proven itself to be the most reliable way to develop robust and reliable software, and the fact that anyone can access the software means that everyone can start with the same set of excellent tools, be they expert or enthusiastic amateur. + +Python everywhere +~~~~~~~~~~~~~~~~~ + +A modern computing project can't ignore the biggest development in computing of the last 10 years. Python prides itself on being a cross-platform language. 10 years ago, being cross-platform meant being available for Windows, macOS and Linux. These days, mobile computing is much more important. Despite this, there aren't many good options for Python programming on mobile platforms, and cross-platform mobile coding is still elusive. + +BeeWare embraces mobile and other emerging platforms (like watches and set-top-boxes) as a first class citizen of the computing ecosystem - because if people have these devices, why shouldn't they be able to write software for them in Python. + +Native everywhere +~~~~~~~~~~~~~~~~~~ + +It's easy to use themes to achieve cross-platform. However, it's easy to spot apps that have been built using themes - they're the ones that don't behave quite like any other app. Widgets don't look *quite* right, or there's a menu bar on a window in an OS X app. Themes can get quite close - but there are always telltale signs. + +On top of that, native widgets are always faster than a themed generic widget. After all, you're using native system capability that has been tuned and optimized, not a drawing engine that's been layered on top of a generic widget. + +Themes also miss many of the accessibility benefits of native platforms. Modern OS authors spend a lot of time tuning affordances for people with impaired mobility, vision or cognition. If you use native widgets, you usually get these affordances for free. If you reimplement widgets with a theme, you also have to re-implement the affordances. + +BeeWare uses native widgets and native functionality, rather than using a theme-based approach to application development. + +Python native +~~~~~~~~~~~~~ + +BeeWare is also an unapologetically "Python first" framework. We like Python. We like the way it looks, and the way it works. If Python isn't available as a first-class option on a particular platform, we'll do whatever is necessary to make Python available as a development language. And when we have the opportunity to embrace Python idiom for an API or a design, we're going to do just that. That means we're going to use generators, context managers, `yield from` asynchronous calls, and more, in order to provide the best Python-native API for cross-platform app development. + +We're also looking to the future - this means that we support Python 3 exclusively. + +Native experience +~~~~~~~~~~~~~~~~~ + +The experience of using any tool starts with the installation process. Part of BeeWare's "Native everywhere" philosophy is adopting appropriate native mechanisms for installation. If you're using a user-space tool, it should be presented to you as an package that installed in the same way you would install any other tool - be that through an app store, an installer, or a simple executable package. End users shouldn't know that you've written the application in Python. + +But if you're using a developer tool or library, then it should integrate with your development environment. And since we're using Python, that means you should be able to install it into your virtual environment using `pip install` and nothing more. No C-extensions, no compilers, no setting system paths or environment variables - Just install it, import it, and start writing (or running) code. + +More than just code +=================== + +It's about more than just code, though. A successful software project requires documentation, design skills, feedback and bug reports. The BeeWare community acknowledges that *all* contributions are important - not just the ones that come as a pull request on GitHub. + +Even then, it's easy to think of a project in a vacuum, as the sum of all contributions. But that's never the case. An open source project is about community. + +Diversity and inclusion +~~~~~~~~~~~~~~~~~~~~~~~ + +A diverse community is a strong community. This means accepting people of all levels of experience, from all backgrounds, of all races, creeds, orientations and expressions. The BeeWare project is committed to developing and maintaining a inclusive, diverse and welcoming community. + +To back this up, we have an open offer to mentor anyone who wants to get involved as a contributor, and a `Code of Conduct`_ that is rigorously enforced. Any reports of violations of that code of conduct - even by senior community members - will be treated with respect and actioned appropriately. + +.. _Code of Conduct: /community/behavior/code-of-conduct/ + +Healthy and sustainable +~~~~~~~~~~~~~~~~~~~~~~~ + +It's also important to make sure that the community is accessible and sustainable. It's unfortunately become an accepted part of Open Source culture that "true" Open Source projects have to be developed entirely by volunteers. This acts as a barrier to entry for many groups - the only people able to spend their free time volunteering are those that *have* free time. + +It also frequently leads to burnout and other mental health issues amongst contributors. The fact that depression, anxiety, and burnout are so common in software development communities shouldn't be considered a badge of honour, or a demonstration of how committed a development team can be. It's a problem that needs to be tackled head on, and addressed in the same way a software bug would be addressed - with immediate workarounds, and long term plans to remove the systemic cause of the problem. + +While we place incredible value on the contributions of volunteers, we also know that volunteer efforts alone aren't the way to develop a healthy and sustainable community. For that reason, financial sustainability is a key consideration in the operation of the BeeWare project. As a community, we don't ignore the role that money has to play in providing the resources that allows people to begin and continue to contribute. We will, as a community, provide accepted mechanisms for individuals to monetize their work in meaningful ways, and wherever possible, compensate people for their work - without compromising the ideals of Open Source development. + +BeeWare: The IDEs of Python +=========================== + +This is BeeWare. We're incredibly excited about what the future holds for Python. We hope you'll join us on this journey. + +--- +gutter: + +* `History`_ + - `The Unix Philosophy`_ +* `The Goal`_ + - `Python everywhere`_ + - `Native everywhere`_ + - `Python native`_ + - `Native experience`_ +* `More than just code`_ + - `Diversity and inclusion`_ + - `Healthy and sustainable`_ + +.. _`History`: ./#history +.. _`The Unix Philosophy`: ./#the-unix-philosophy +.. _`The Goal`: ./#the-goal +.. _`Python everywhere`: ./#python-everywhere +.. _`Native everywhere`: ./#native-everywhere +.. _`Python native`: ./#python-native +.. _`Native experience`: ./#native-experience +.. _`More than just code`: ./#more-than-just-code +.. _`Diversity and inclusion`: ./#diversity-and-inclusion +.. _`Healthy and sustainable`: ./#healthy-and-sustainable + +--- +sort_key: 2 +--- +summary: The history and philosophy of the BeeWare Project +--- +title: About BeeWare diff --git a/content/project/contents+pt.lr b/content/project/contents+pt.lr new file mode 100644 index 0000000..c1824ba --- /dev/null +++ b/content/project/contents+pt.lr @@ -0,0 +1,17 @@ +_template: beeware.html +--- +gutter: + +Conheça o Brutus +================= +.. image:: /static/images/brutus-128.png + +A Abelha Brutus é a mascote do Projeto BeeWare. Ela é uma abelhinha muito ocupada e trabalhadora. + +Fato divertido: Quem cuida de abelhas é chamado **apicultor** - um dos nomes que o projeto BeeWare usa para descrever a equipe principal. Isso também se reflete no relacionamento que a equipe principal quer ter com a comunidade - somos pastores da comunidade e daremos orientação, mas sabemos que o trabalho de verdade é feito pela comunidade como um todo. +--- +sort_key: 3 +--- +summary: O que é o Projeto BeeWare? +--- +title: O Projeto BeeWare diff --git a/content/project/overview/contents+pt.lr b/content/project/overview/contents+pt.lr new file mode 100644 index 0000000..4db0f06 --- /dev/null +++ b/content/project/overview/contents+pt.lr @@ -0,0 +1,44 @@ +body: + + +Python já demonstrou ser uma linguagem altamente poderosa - acessível para novatos, mas poderosa nas mãos de especialistas. O Projeto BeeWare busca usar a força do Python como linguagem para capacitar usuários de todos os níveis de conhecimento a desenvolver aplicações com interfaces nativas para usuários. + +O objetivo final do projeto BeeWare: Fazer para o software de dispositivos móveis e desktop o mesmo que o Django fez para o software web - fornecer aos usuários um conjunto de ferramenttas e bibliotecas, que permita que desenvolvam interfaces de usuário ricas e nativas e implementá-las em seus dispositivos. Isso inclui: + +* Ferramentas para permitir que o Python rode em dispositivos diferentes, +* Ferramentas para embalar um projeto Python de modo a rodar nestes dispositivos, +* Bibliotecas para acessar os widgets e capacidades nativos dos dispositivos, +* Ferramentas para ajudar a desenvolver, debugar, analisar e implementar esse projetos. + +Este objetivo é que este conjunto de ferramentas seja suficientemente fácil de usar para novatos completos em uma configuração semelhante à das Django Girls; mas poderoso o suficiente para que possam ser usadas para o próximo Instagram, Pinterest ou Disqus. + +Mas não pensamos apenas em software. Também temos como objetivo ser um projeto com consciência social. Temos o objetivo de desenvolver e manter uma comunidade diversa e inclusiva e temos um Código de Conduta que é aplicado rigorosamente. Também almejamos desenvolver uma comunidade saudável e sustentável - uma que tenha consciência dos problemas de saúde mental de seus participantes e forneça recursos para as pessoas começarem a participar e continuarem participando da comunidade. + +E daqui, para onde? +=================== + +Se vc quer saber mais sobre a história do BeeWare, `comece aqui (em inglês) `__. + +Se quiser fazer um test-drive do BeeWare, `dê uma olhada nas várias formas com que as ferramentas BeeWare podem ser usadas (em inglês) `__. + +Se quiser se manter atualizado com o que estamos fazendo, siga `@PyBeeWare `__ no Twitter (em inglês). Se quiser receber atualizações, dicas e anúncios sobre o projeto BeeWare, `assine a lista de e-mail dos Entusiastas do Beeware (em inglês) `__. + +--- +gutter: + +Próximos passos +=============== + +* `História do projeto BeeWare `__ +* `test drive do BeeWare `__ +* `@PyBeeWare no Twitter `__ +* `Lista de e-mail dos Entusiastas do Beeware (BeeWare Enthusiasts mailing list) `__ + +--- +incomplete: no +--- +sort_key: 1 +--- +summary: Introdução ao projeto BeeWare +--- +title: O que é o BeeWare? From b8d75fb09482589f9b13f86b3b62c9aabd8f697e Mon Sep 17 00:00:00 2001 From: "J. Rodolfo" Date: Sun, 22 Oct 2017 23:27:55 -0200 Subject: [PATCH 2/7] DONE - small correction: corrected README.rst to say lektor also uses Python 3 --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 32808ac..3c79350 100644 --- a/README.rst +++ b/README.rst @@ -16,7 +16,7 @@ submit a pull request. However, **do not fork the master branch** - fork the .. _lektor branch: https://github.com/pybee/pybee.github.io/tree/lektor If you want to test out a change before you submit it, download and install -`Lektor`_ (note that Lektor is still using Python 2.7): +`Lektor`_ (note that Lektor can use Python 2.7 or Python 3.x): $ pip install lektor From 60a279ad39907c80b478e756b0a69ecfb3a1a2d4 Mon Sep 17 00:00:00 2001 From: "J. Rodolfo" Date: Sun, 22 Oct 2017 23:29:59 -0200 Subject: [PATCH 3/7] DONE - small correction: corrected README.rst to say lektor also uses Python 3 --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 3c79350..ba96b63 100644 --- a/README.rst +++ b/README.rst @@ -16,7 +16,7 @@ submit a pull request. However, **do not fork the master branch** - fork the .. _lektor branch: https://github.com/pybee/pybee.github.io/tree/lektor If you want to test out a change before you submit it, download and install -`Lektor`_ (note that Lektor can use Python 2.7 or Python 3.x): +`Lektor`_ (note: Lektor can use Python 2.7 or Python 3.x): $ pip install lektor From 2b88b8c2224059634b5d3a7a0930ae96b5b5d185 Mon Sep 17 00:00:00 2001 From: "J. Rodolfo" Date: Mon, 23 Oct 2017 11:56:16 -0200 Subject: [PATCH 4/7] Page "Projects" (tab of Project) translated to pt_BR (DONE) --- content/project/projects/contents+pt.lr | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 content/project/projects/contents+pt.lr diff --git a/content/project/projects/contents+pt.lr b/content/project/projects/contents+pt.lr new file mode 100644 index 0000000..4145927 --- /dev/null +++ b/content/project/projects/contents+pt.lr @@ -0,0 +1,11 @@ +_slug: +--- +_template: projects.html +--- +body: BeeWare não é uma única ferramenta ou biblioteca - é uma coleção de projetos que podem ser usados para ajudar a desenvolver, depurar e lançar software Python. Cada ferramenta segue a filosofia Unix de fazer bem uma coisa. Cada ferramenta pode ser usada isoladamente, ou pode ser encadeada para fornecer um conjunto rico de ferramentas de programação. +--- +sort_key: 4 +--- +summary: No que consiste o projeto BeeWare? +--- +title: Projetos From 0cc1cd135df996d65d8f9522f2b3ca571d03b6ab Mon Sep 17 00:00:00 2001 From: "J. Rodolfo" Date: Mon, 23 Oct 2017 12:13:23 -0200 Subject: [PATCH 5/7] Translation of projects tab (under Project) to pt_BR (with small corrections - DONE) --- content/project/projects/contents+pt.lr | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/project/projects/contents+pt.lr b/content/project/projects/contents+pt.lr index 4145927..c7ce05b 100644 --- a/content/project/projects/contents+pt.lr +++ b/content/project/projects/contents+pt.lr @@ -2,7 +2,7 @@ _slug: --- _template: projects.html --- -body: BeeWare não é uma única ferramenta ou biblioteca - é uma coleção de projetos que podem ser usados para ajudar a desenvolver, depurar e lançar software Python. Cada ferramenta segue a filosofia Unix de fazer bem uma coisa. Cada ferramenta pode ser usada isoladamente, ou pode ser encadeada para fornecer um conjunto rico de ferramentas de programação. +body: O BeeWare não é uma única ferramenta ou biblioteca - é uma coleção de projetos que podem ser usados para ajudar a desenvolver, depurar e lançar software Python. Cada ferramenta segue a filosofia Unix de fazer bem uma coisa. Cada ferramenta pode ser usada isoladamente, ou pode ser encadeada para fornecer um conjunto rico de ferramentas de programação. --- sort_key: 4 --- From 9a320b53d79c5ace0442e3b91ee3efd3a18b6852 Mon Sep 17 00:00:00 2001 From: Elias Dorneles Date: Tue, 31 Oct 2017 00:49:35 +0100 Subject: [PATCH 6/7] Update README.rst --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index ba96b63..aa4218a 100644 --- a/README.rst +++ b/README.rst @@ -16,7 +16,7 @@ submit a pull request. However, **do not fork the master branch** - fork the .. _lektor branch: https://github.com/pybee/pybee.github.io/tree/lektor If you want to test out a change before you submit it, download and install -`Lektor`_ (note: Lektor can use Python 2.7 or Python 3.x): +`Lektor`_ (note: currently it's better to use Lektor with Python 2.7): $ pip install lektor From c8cf464680d4df9092e412dcfec6c10133a78396 Mon Sep 17 00:00:00 2001 From: Elias Dorneles Date: Tue, 31 Oct 2017 00:51:00 +0100 Subject: [PATCH 7/7] Typo fix --- content/project/overview/contents+pt.lr | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/project/overview/contents+pt.lr b/content/project/overview/contents+pt.lr index 4db0f06..60c7877 100644 --- a/content/project/overview/contents+pt.lr +++ b/content/project/overview/contents+pt.lr @@ -10,7 +10,7 @@ O objetivo final do projeto BeeWare: Fazer para o software de dispositivos móve * Bibliotecas para acessar os widgets e capacidades nativos dos dispositivos, * Ferramentas para ajudar a desenvolver, debugar, analisar e implementar esse projetos. -Este objetivo é que este conjunto de ferramentas seja suficientemente fácil de usar para novatos completos em uma configuração semelhante à das Django Girls; mas poderoso o suficiente para que possam ser usadas para o próximo Instagram, Pinterest ou Disqus. +O objetivo é que este conjunto de ferramentas seja suficientemente fácil de usar para novatos completos em uma configuração semelhante à das Django Girls; mas poderoso o suficiente para que possam ser usadas para o próximo Instagram, Pinterest ou Disqus. Mas não pensamos apenas em software. Também temos como objetivo ser um projeto com consciência social. Temos o objetivo de desenvolver e manter uma comunidade diversa e inclusiva e temos um Código de Conduta que é aplicado rigorosamente. Também almejamos desenvolver uma comunidade saudável e sustentável - uma que tenha consciência dos problemas de saúde mental de seus participantes e forneça recursos para as pessoas começarem a participar e continuarem participando da comunidade.