Skip to content

Commit

Permalink
update docs with pt-BR translation
Browse files Browse the repository at this point in the history
  • Loading branch information
myst729 committed Nov 14, 2017
1 parent 11afd63 commit ff3b93a
Show file tree
Hide file tree
Showing 16 changed files with 692 additions and 26 deletions.
2 changes: 1 addition & 1 deletion docs/index.html
Original file line number Diff line number Diff line change
@@ -1 +1 @@
<!DOCTYPE html><html><head><meta charset=utf-8><title>Vuelog</title><meta name=viewport content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no,minimal-ui"><link rel=icon href=./static/vuelog.png type=image/png sizes=256x256><link rel=icon href=./static/vuelog.svg type=image/svg+xml sizes=any><link href=./static/css/app.655bae11b981fa78f764e31bb5822407.css rel=stylesheet></head><body><div id=app><p class=loading>Loading...</p></div><script src=./userdata/database.js></script><script type=text/javascript src=./static/js/manifest.6d2cd4b9649865f3ece3.js></script><script type=text/javascript src=./static/js/vendor.d63850d0407f42486ba8.js></script><script type=text/javascript src=./static/js/app.4c2402771f8fa633b87d.js></script></body></html>
<!DOCTYPE html><html><head><meta charset=utf-8><title>Vuelog</title><meta name=viewport content="width=device-width,initial-scale=1,maximum-scale=1,user-scalable=no,minimal-ui"><link rel=icon href=./static/vuelog.png type=image/png sizes=256x256><link rel=icon href=./static/vuelog.svg type=image/svg+xml sizes=any><link href=./static/css/app.655bae11b981fa78f764e31bb5822407.css rel=stylesheet></head><body><div id=app><p class=loading>Loading...</p></div><script src=./userdata/database.js></script><script type=text/javascript src=./static/js/manifest.a7255a0d7e7271a38bef.js></script><script type=text/javascript src=./static/js/vendor.d63850d0407f42486ba8.js></script><script type=text/javascript src=./static/js/app.dc5f54fa38a6551f84c2.js></script></body></html>
1 change: 0 additions & 1 deletion docs/static/js/app.4c2402771f8fa633b87d.js

This file was deleted.

1 change: 1 addition & 0 deletions docs/static/js/app.dc5f54fa38a6551f84c2.js

Large diffs are not rendered by default.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

62 changes: 41 additions & 21 deletions docs/userdata/database.js
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@ window.VUELOG_DATABASE = {
brand: {
'en-US': 'Vuelog',
'zh-CN': 'Vuelog',
'de-DE': 'Vuelog'
'de-DE': 'Vuelog',
'pt-BR': 'Vuelog'
},

// Put the site brand behind current page in `document.title`.
Expand Down Expand Up @@ -53,7 +54,8 @@ window.VUELOG_DATABASE = {
label: {
'en-US': 'Guide',
'zh-CN': '指南',
'de-DE': 'Anleitung'
'de-DE': 'Anleitung',
'pt-BR': 'Guia'
},
type: 'page',
path: '/page/guide'
Expand All @@ -62,7 +64,8 @@ window.VUELOG_DATABASE = {
label: {
'en-US': 'About',
'zh-CN': '关于',
'de-DE': 'Über'
'de-DE': 'Über',
'pt-BR': 'Sobre'
},
type: 'page',
path: '/page/about'
Expand All @@ -71,7 +74,8 @@ window.VUELOG_DATABASE = {
label: {
'en-US': 'Showcase',
'zh-CN': '示例',
'de-DE': 'Beispiele'
'de-DE': 'Beispiele',
'pt-BR': 'Exemplos'
},
type: 'category',
path: '/blog/showcase'
Expand All @@ -80,7 +84,8 @@ window.VUELOG_DATABASE = {
label: {
'en-US': 'Archive',
'zh-CN': '归档',
'de-DE': 'Archiv'
'de-DE': 'Archiv',
'pt-BR': 'Arquivo'
},
type: 'archive',
path: '/archive'
Expand All @@ -89,13 +94,14 @@ window.VUELOG_DATABASE = {
label: {
'en-US': 'Links',
'zh-CN': '链接',
'de-DE': 'Links'
'de-DE': 'Links',
'pt-BR': 'Links'
},
type: 'dropdown',
path: '', // (OPTIONAL) dropdown can be routable too if you set a valid route path
children: [
{
label: { 'en-US': 'Weibo', 'zh-CN': '微博', 'de-DE': 'Weibo' },
label: { 'en-US': 'Weibo', 'zh-CN': '微博', 'de-DE': 'Weibo', 'pt-BR': 'Weibo' },
type: 'outgoing',
link: 'http://weibo.com/myst729'
},
Expand All @@ -118,7 +124,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Vuelog Guide',
'zh-CN': 'Vuelog 指南',
'de-DE': 'Vuelog Anleitung'
'de-DE': 'Vuelog Anleitung',
'pt-BR': 'Guia Vuelog'
},
slug: 'guide',
exclude: true, // (OPTIONAL) `true` to exclude the page from archive view
Expand All @@ -130,15 +137,17 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'About Vuelog',
'zh-CN': '关于 Vuelog',
'de-DE': 'Über Vuelog'
'de-DE': 'Über Vuelog',
'pt-BR': 'Sobre o Vuelog'
},
slug: 'about'
},
{
title: {
'en-US': 'Changelog',
'zh-CN': '变更日志',
'de-DE': 'Änderungen'
'de-DE': 'Änderungen',
'pt-BR': 'Changelog'
},
slug: 'changelog'
}
Expand All @@ -149,15 +158,17 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Documentation',
'zh-CN': '文档',
'de-DE': 'Dokumentation'
'de-DE': 'Dokumentation',
'pt-BR': 'Documentação'
},
slug: 'docs'
},
{
title: {
'en-US': 'Showcase',
'zh-CN': '示例',
'de-DE': 'Beispiele'
'de-DE': 'Beispiele',
'pt-BR': 'Exemplos'
},
slug: 'showcase'
}
Expand All @@ -169,7 +180,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Multiple languages support',
'zh-CN': '多语言支持',
'de-DE': 'Untersützung mehrerer Sprachen'
'de-DE': 'Untersützung mehrerer Sprachen',
'pt-BR': 'Suporte a vários Idiomas'
},
slug: 'multiple-languages-support',
category: 'docs',
Expand All @@ -179,7 +191,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Use social commenting services',
'zh-CN': '使用社会化评论服务',
'de-DE': 'Benutzung sozialer Kommentardienste'
'de-DE': 'Benutzung sozialer Kommentardienste',
'pt-BR': 'Uso de Serviços Sociais de Comentários'
},
slug: 'use-social-commenting-services',
category: 'docs',
Expand All @@ -190,7 +203,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Insert code blocks with syntax highlight',
'zh-CN': '插入语法高亮的代码块',
'de-DE': 'Einfügen von Code Blöcken mit Syntax Highlighting'
'de-DE': 'Einfügen von Code Blöcken mit Syntax Highlighting',
'pt-BR': 'Inserir blocos de código com realce de sintaxe'
},
slug: 'insert-code-blocks-with-syntax-highlight',
category: 'docs',
Expand All @@ -200,7 +214,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Author posts or pages',
'zh-CN': '编写文章或页面',
'de-DE': 'Beiträge und Seiten verfassen'
'de-DE': 'Beiträge und Seiten verfassen',
'pt-BR': 'Posts ou Páginas por Autor'
},
slug: 'author-posts-or-pages',
category: 'docs',
Expand All @@ -211,7 +226,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Add posts or pages',
'zh-CN': '新建文章或页面',
'de-DE': 'Beiträge und Seiten hinzufügen'
'de-DE': 'Beiträge und Seiten hinzufügen',
'pt-BR': 'Adicionar Posts ou Páginas'
},
slug: 'add-posts-or-pages',
category: 'docs',
Expand All @@ -221,7 +237,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Customize navigation menu',
'zh-CN': '自定义导航菜单',
'de-DE': 'Navigationsmenü anpassen'
'de-DE': 'Navigationsmenü anpassen',
'pt-BR': 'Customizar o menu de navegação'
},
slug: 'customize-navigation-menu',
category: 'docs',
Expand All @@ -231,7 +248,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Customize the site',
'zh-CN': '自定义站点',
'de-DE': 'Seite anpassen'
'de-DE': 'Seite anpassen',
'pt-BR': 'Customizar o site'
},
slug: 'customize-the-site',
category: 'docs',
Expand All @@ -242,7 +260,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'File structure of Vuelog',
'zh-CN': 'Vuelog 文件结构',
'de-DE': 'Dateistruktur von Vuelog'
'de-DE': 'Dateistruktur von Vuelog',
'pt-BR': 'Estrutura do Diretório do Vuelog'
},
slug: 'file-structure-of-vuelog',
category: 'docs',
Expand All @@ -252,7 +271,8 @@ window.VUELOG_DATABASE = {
title: {
'en-US': 'Style examples',
'zh-CN': '样式示例',
'de-DE': 'Style Beispiele'
'de-DE': 'Style Beispiele',
'pt-BR': 'Exemplos de estilo'
},
slug: 'style-examples',
category: 'showcase',
Expand Down
38 changes: 38 additions & 0 deletions docs/userdata/pages/about.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,3 +75,41 @@ The latest version is totally rewritten, built on vue 2.x, vue-router 2.x and vu
新版本是完全重写的,基于 vue 2.x、vue-router 2.x 和 vuex 2.x 构建,并且在持续地开发新功能,修复问题,以及升级依赖。

<!-- zh-CN:- -->

<!-- pt-BR:+ -->

### Qual o motivo da criação do Vuelog?

Anos atrás, eu migrei meu blog para o [Github Pages](https://pages.github.com/). Naquele tempo, eu tinha algumas escolhas: Jekyll, Hexo ou algo que eu mesmo fizesse com AngularJS. Finalmente eu escolhi [Hexo](https://hexo.io/) para gerar sites estáticos, porque eu sou muito preguiçoso e não gosto de Ruby.

Antes do Hexo, eu estava utilizando [Wordpress](https://wordpress.org/). Era muito simples - _logava_, escrevia alguma coisa, publicava. Com Hexo, toda vez que eu quisesse escrever algo, eu precisava gerar todo o site estático localmente depois de finalizar o post, e somente então gerar uma cópia através do client do git. No começo eu pensava "bem, é entediante mas eu consigo lidar com isso". Entretanto, uma coisa mudou meu pensamento - Eu comprei um novo notebook. Você deve saber como é o trabalhão de configurar todo o novo _work station_. Hexo só faz o upload do site gerado para o Github, todas as configurações e os arquivos markdown são armazenados localmente. Felizmente, eu não formatei o antigo notebook, mas percebi que não fiz o backup deles.

Então eu pensei, eu posso colocar as configurações no próprio repositório do Github? Ou também, eu poderia me livrar de _buildar_ o site estático e copiá-lo toda vez? A resposta do desenvolvedor é (sempre) construir as suas próprias rodas. Neste momento, eu prometi a mim mesmo não ser mais preguiçoso.

<blockquote class="tip">
<p>Se você entende Chinês, aqui está uma [issue no GitHub](https://github.com/myst729/Vuelog/issues/6) criada por um membro do time Hexo, que fala um pouco disso também.</p>
</blockquote>

### Por quê VueJS?

Por quê não AngularJS ou React?

AngularJS (1.x) não é uma opção porque eu o uso muito no meu trabalho. Então eu pensei em testar algo que eu nunca utilizei antes.

[Vue](https://vuejs.org/) tem uma biblioteca básica bem feita. Suas API's são inspiradas nas do AngularJS, além de ser muito atrativo para desenvolvedores farmiliarizados com o Angular, assim como eu. Também vale a pena dizer que é uma ferramenta bem leve e com uma boa performance.

Além da documentação incrível, Vue tem uma linha completa de desenvolvimento, incluindo a maravilhosa ferramenta [vue-cli](https://github.com/vuejs/vue-cli), roteamento pelo lado do cliente ([vue-router](https://github.com/vuejs/vue-router)), gerenciamento de estado central ([vuex](https://github.com/vuejs/vuex)), um add-on para o Chrome DevTools ([vue-devtools](https://github.com/vuejs/vue-devtools)) e várias outras ferramentas úteis.

Eu já escrevi algumas cosas com React antes, mas nada que me deu uma verdadeira chance de usa-lo como ferramenta real. Ele apenas não me atrai muito. React tem seu próprio ecosistema. Talvez eu o use no meu próximo projeto.

### Quem pode utilizar o Vuelog?

Qualquer pessoa, desde que esteja interessada em escrever mais do que 140 palavras (caractéres), e tenha um local (exemplo Github pages), para hospedar seus escritos.

### O projeto ainda vive?

Claro! No começo era apenas experimental. Conforme eu ia aprendendo mais sobre o Vue e outros add-ons úteis, eu decidi continuar incrementando, não apenas para consolidar meus conhecimentos com Vue, mas para me manter feliz escrevendo.

A última versão está totalmente re-escrita, construída com Vue 2.x, vue-router 2.x e vuex 2.x agora. Também continuo acrescentando novas funcionalidades, concertando _bugs_ e atualizando as dependências.

<!-- pt-BR:- -->
22 changes: 22 additions & 0 deletions docs/userdata/pages/guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,25 @@ title: Guide
- [样式示例](#/blog/showcase/2016/style-examples)

<!-- zh-CN:- -->

<!-- pt-BR:+ -->

#### Visão Geral

- [Estrutura do Diretório do Vuelog](#/blog/docs/2016/file-structure-of-vuelog)

#### Documentation

- [Customizando o Site](#/blog/docs/2017/customize-the-site)
- [Customizar o menu de navegação](#/blog/docs/2017/customize-navigation-menu)
- [Adicionar posts ou páginas](#/blog/docs/2017/add-posts-or-pages)
- [Posts ou páginas por autor](#/blog/docs/2017/author-posts-or-pages)
- [Inserir blocos de código com realce de sintaxe](#/blog/docs/2017/insert-code-blocks-with-syntax-highlight)
- [Suporte a vários idiomas](#/blog/docs/2017/multiple-languages-support)
- [Uso de Serviços sociais de Comentários](#/blog/docs/2017/use-social-commenting-services)

#### Showcase

- [Exemplos de estilo](#/blog/showcase/2016/style-examples)

<!-- pt-BR:- -->
38 changes: 38 additions & 0 deletions docs/userdata/posts/2016/file-structure-of-vuelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,3 +79,41 @@ For process to publish pages/posts, read [add posts or pages](#/blog/docs/2017/a
关于发布文章和页面的流程,请阅读[新建文章或页面](#/blog/docs/2017/add-posts-or-pages)[编写文章或页面](#/blog/docs/2017/author-posts-or-pages)

<!-- zh-CN:- -->

<!-- pt-BR:+ -->
Aqui está a estrutura típica do diretório de um site desenvolvido com Vuelog:

```bash
/
├── index.html
├── static/
│ ├── css/
│ └── js/
└── userdata/
├── database.js
├── pages/
│   ├── all-about-vuelog.md
│   └── changelog.md
└── posts/
└── 2016/
├── how-to-add-a-post-or-page.md
├── the-so-called-database.md
├── the-structure-of-vuelog.md
└── the-styles.md
```

Iremos passar por eles, um por um:

- `index.html`: O ponto de entrada do site. Normalmente você não precisa mexer em nada aqui.
- `static/`: Este diretório contém os arquivos principais, já compilados, do Vuelog, assim como os arquivos JavaScript e CSS. **Você não deve nunca tocar neste diretório, ou seu site pode ir ladeira a baixo**
- `userdata/`: Onde você põe seus arquivos Markdown dos posts e páginas. **NUNCA mude o nome do diretório.**
-`database.js`: O arquivo mais importante com o qual você terá de lidar. Todas as suas configurações e dados dos seus posts e páginas estão armazenados aqui.
-`pages/`: A fonte dos arquivos markdown das suas páginas estão armazenados aqui.
-`posts/`: A fonte dos arquivos markdown de seus posts estão armazenados aqui, listados por sub-diretórios nomeados pelo ano.
-`2016/`: O nome do diretório indica o ano em que os posts, aqui introduzidos, foram publicados.

Você pode colocar outros arquvios estáticos no `userdata/` como por exemplo as imagens referenciadas nas suas páginas e posts.

Para entender sobre o processo de publicação de páginas e posts leia [Adicionar posts ou páginas](#/blog/docs/2017/add-posts-or-pages) e [Posts ou páginas por Autor](#/blog/docs/2017/author-posts-or-pages).

<!-- pt-BR:- -->
Loading

0 comments on commit ff3b93a

Please sign in to comment.