-
-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #2761 from abnersajr/ptBr-translations
Pt br translations
- Loading branch information
Showing
8 changed files
with
156 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,75 @@ | ||
# Build | ||
|
||
Esta página também está disponível em [Japônes](https://github.com/BoostIO/Boostnote/blob/master/docs/jp/build.md), [Coreano](https://github.com/BoostIO/Boostnote/blob/master/docs/ko/build.md), [Russo](https://github.com/BoostIO/Boostnote/blob/master/docs/ru/build.md), [Chinês simplificado](https://github.com/BoostIO/Boostnote/blob/master/docs/zh_CN/build.md), [Francês](https://github.com/BoostIO/Boostnote/blob/master/docs/fr/build.md) e [Alemão](https://github.com/BoostIO/Boostnote/blob/master/docs/de/build.md). | ||
|
||
## Ambiente | ||
|
||
- npm: 6.x | ||
- node: 8.x | ||
|
||
## Desenvolvimento | ||
|
||
Nós usamos o Webpack HMR para desenvolver o Boostnote. | ||
Ao executar os seguintes comandos no diretório raiz do projeto, o Boostnote será iniciado com as configurações padrão. | ||
|
||
Instala os pacotes necessários usando o yarn. | ||
|
||
``` | ||
$ yarn | ||
``` | ||
|
||
Gerar e iniciar. | ||
|
||
``` | ||
$ yarn run dev | ||
``` | ||
|
||
> ### Notice | ||
> | ||
> Existe alguns casos onde você precisa atualizar o app manualmente. | ||
> | ||
> 1. Quando editar um método construtor de um componente | ||
> 2. Quando adicionar uma nova classe de css (similiar ao 1: a classe do css é reescrita por cada componente. Esse processo ocorre através do método construtor) | ||
## Deploy | ||
|
||
Nós usamos o Grunt para automatizar o desenvolvimento. | ||
Você pode gerar o programa usando `grunt`. Contudo, nós não recomendamos isso porque a tarefa padrão inclui _codedesign_ e _authenticode_. | ||
|
||
Então nós preparamos um _script_ separado, o qual somente cria um executável. | ||
|
||
``` | ||
grunt pre-build | ||
``` | ||
|
||
Você irá encontrar o executável na pasta `dist`. Nota: o atualizador automático não funciona porque o app não está certificado. | ||
|
||
Se você achar isto necessário, você pode usar o _codesign_ ou o _authenticode_ com esse executável. | ||
|
||
## Faça seus próprios pacotes de distribuição (deb, rpm) | ||
|
||
Pacotes de distribuição são gerados através do comando `grunt build` em plataforma Linux (e.g. Ubuntu, Fedora). | ||
|
||
> Nota: você pode criar `.deb` e `.rpm` em um mesmo ambiente. | ||
Depois de instalar uma versão suportada do `node` e do `npm`, deve-se instalar as dependências para gerar os pacotes. | ||
|
||
Ubuntu/Debian: | ||
|
||
``` | ||
$ sudo apt-get install -y rpm fakeroot | ||
``` | ||
|
||
Fedora: | ||
|
||
``` | ||
$ sudo dnf install -y dpkg dpkg-dev rpm-build fakeroot | ||
``` | ||
|
||
Então execute `grunt build`. | ||
|
||
``` | ||
$ grunt build | ||
``` | ||
|
||
Você vai encontrar o `.deb` e o `.rpm` na pasta`dist`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,40 @@ | ||
# Como debugar Boostnote (app Electron) | ||
|
||
Esta página também está disponível em [Japônes](https://github.com/BoostIO/Boostnote/blob/master/docs/jp/debug.md), [Coreano](https://github.com/BoostIO/Boostnote/blob/master/docs/ko/debug.md), [Russo](https://github.com/BoostIO/Boostnote/blob/master/docs/ru/debug.md), [Chinês simplificado](https://github.com/BoostIO/Boostnote/blob/master/docs/zh_CN/debug.md), [Francês](https://github.com/BoostIO/Boostnote/blob/master/docs/fr/debug.md) e [Alemão](https://github.com/BoostIO/Boostnote/blob/master/docs/de/debug.md). | ||
|
||
## Debugar com o Google Chrome developer Tools | ||
|
||
Boostnote é um app Electron, por isso ele é baseado no Chromium; desenvolvedores podem usar o `Developer Tools` igual no Google Chrome. | ||
|
||
Você pode habilitar e desabilitar o `Developer Tools` assim: | ||
![how_to_toggle_devTools](https://cloud.githubusercontent.com/assets/11307908/24343585/162187e2-127c-11e7-9c01-23578db03ecf.png) | ||
|
||
O `Developer Tools` deve parecer assim: | ||
![Developer_Tools](https://cloud.githubusercontent.com/assets/11307908/24343545/eff9f3a6-127b-11e7-94cf-cb67bfda634a.png) | ||
|
||
Quando erros acontecem, eles são apresentados na aba `console`. | ||
|
||
### Debugando | ||
|
||
Por exemplo, você pode usar o `debugger` para adicionar um _breakpoint_ (ponto de parada) no código dessa forma: | ||
|
||
![debugger](https://cloud.githubusercontent.com/assets/11307908/24343879/9459efea-127d-11e7-9943-f60bf7f66d4a.png) | ||
|
||
Isso é só um exemplo ilustrativo, mas você deve encontrar um jeito de debugar que encaixe no seu estilo. | ||
|
||
### Referências | ||
|
||
- [Documentação do Google Chrome sobre como debugar](https://developer.chrome.com/devtools) | ||
|
||
## Debugar com o Visual Studio Code (VS Code) | ||
|
||
1. Instale o plugin **[Debugger for Chrome](https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome 'Instale o pacote Debugger for Chrome')** para Visual Studio Code. Então reinicie-o. | ||
2. Pressione **Shift+Command+B** ou execute **Run Build Task** do menu global **Terminal**, então seleciona a task **Build Boostnote**. Ou execute `yarn run watch` no terminal. | ||
3. Quando a task acima estiver rodando, abra o **Debug view** na **Activity Bar** no lado do seu VS Code ou use o atalho **Shift+Command+D**. | ||
4. Selecione a configuração **Boostnote All** no **Debug configuration**, então clique na seta verde ou aperte **F5** para começar a debugar. | ||
5. Agora você deve encontrar seu **Boostnote** rodando. Você vai ver dois processos rodando, um com nome de **Boostnote Main** e outro com nome de **Boostnote Renderer**. Agora você pode adicionar os **debug breakpoints** no vscode. Se os seus **breakpoints** não forem alertados você pode precisar altenrar entre os processos **Boostnote Renderer** e **Boostnote Main**. | ||
|
||
### Referências | ||
|
||
- [Debugando uma aplicação Electron](https://electronjs.org/docs/tutorial/application-debugging) | ||
- [Debugger for Chrome](https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters