Skip to content

Commit

Permalink
Add Portuguese translation for website content
Browse files Browse the repository at this point in the history
The Website content in Portuguese has been added and the Portuguese language configuration has been updated in Vitepress. This not only includes basic pages like guides and tutorials but also the home page and other related components. Various reference and supplementary materials have also been translated, providing a fully localized experience for Portuguese speaking users.
  • Loading branch information
gantrol committed Mar 17, 2024
1 parent e2bcf7b commit ae01813
Show file tree
Hide file tree
Showing 9 changed files with 273 additions and 45 deletions.
2 changes: 1 addition & 1 deletion .vitepress/config/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ export default withMermaid(
locales: {
root: { label: 'English', ...en },
zh: { label: '简体中文', ...zh },
// pt: { label: 'Português', ...pt }
pt: { label: 'Português', ...pt },
}
})
)
101 changes: 91 additions & 10 deletions .vitepress/config/pt.ts
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,17 @@ import { defineConfig, type DefaultTheme } from 'vitepress'

export const pt = defineConfig({
lang: 'pt-BR',
description: '',
title: "MarkdownPodeFazer",
description: "Markdown pode fazer isso! Livre-se dos incômodos do Word e da formatação HTML — fácil de usar, eficiente, texto puro, multifuncional, amigável à IA",


themeConfig: {
nav: nav(),

sidebar: {
// '/pt/guide/': { base: '/pt/guide/', items: sidebarGuide() },
// '/pt/reference/': { base: '/pt/reference/', items: sidebarReference() }
'/pt/guide/': { base: '/pt/guide/', items: sidebarGuideAndReference() },
'/pt/reference/': { base: '/pt/reference/', items: sidebarGuideAndReference() },
'/pt/showcase/': { base: '/pt/showcase/', items: sidebarShowcase() },
},

editLink: {
Expand All @@ -19,7 +22,6 @@ export const pt = defineConfig({
},

footer: {
message: 'Lançado sob licença MIT',
copyright: `Direitos reservados © 2024-${new Date().getFullYear()} Gantrol Hwang`
},

Expand Down Expand Up @@ -52,18 +54,97 @@ export const pt = defineConfig({
function nav(): DefaultTheme.NavItem[] {
return [
{
text: 'Guia',
link: '/pt/guide/what-is-',
activeMatch: '/pt/guide/'
text: 'Início',
link: '/pt/',
activeMatch: '^/$',
},
{
text: 'Documentação',
activeMatch: '/pt/[tutorial|guide|showcase|reference]/',
items: [
{
text: 'Tutorial',
link: '/pt/tutorial/',
activeMatch: '/pt/tutorial/',
},
{
text: 'Guia',
link: '/pt/guide/',
activeMatch: '/pt/guide/',
},
{
text: 'Referência',
link: '/pt/reference/resource',
activeMatch: '/pt/reference/resource',
},
{
text: 'Exemplos',
link: '/pt/showcase/',
activeMatch: '^/showcase',
},
]
},
{
text: 'CheatSheet',
link: '/pt/reference/cheatsheet/',
activeMatch: '/pt/reference/cheatsheet/'
},
{
text: 'Referência',
link: '/pt/reference/site-config',
activeMatch: '/pt/reference/'
text: 'Playground',
link: '/pt/playground/',
activeMatch: '/pt/playground/'
}
]
}

function sidebarGuide(): DefaultTheme.SidebarItem[] {
return [
{
text: 'Introdução',
collapsed: false,
items: [
{ text: 'O que o Markdown pode fazer', link: '/' },
{ text: 'Por que usar Markdown?', link: 'why' },
{ text: 'O que é Markdown?', link: 'what-is-markdown' },
]
},
]
}

function sidebarGuideAndReference(): DefaultTheme.SidebarItem[] {
return [
{
text: "Guia",
base: '/pt/guide/',
items: sidebarGuide(),
},
{
text: "Referência",
base: '/pt/reference/',
items: sidebarReference(),
}
]
}



function sidebarReference(): DefaultTheme.SidebarItem[] {
return [
{ text: 'CheatSheet', link: 'cheatsheet/' },
{ text: 'Materiais de Referência', link: 'resource' },
]
}
function sidebarShowcase(): DefaultTheme.SidebarItem[] {
return [
// { text: 'Linha do Tempo Claude Gantt', link: '#mermaid-timeline-claude' },
{ text: 'Linha do Tempo do ChatGPT ', link: '#mermaid-timeline-chatgpt' },
{ text: 'Mapa Mental Mermaid do ChatGPT', link: '#mermaid-mindmap-use-chatgpt' },
{ text: 'Sintaxe Gantt Mermaid', link: '#mermaid-gantt-syntax' },
{ text: 'Fluxograma Mermaid', link: '#mermaid-flowchart' },
{ text: 'Nota de Rodapé Markdown', link: 'footnote' },
// { text: '', link: '' },
]
}
export const search: DefaultTheme.AlgoliaSearchOptions['locales'] = {
pt: {
placeholder: 'Pesquisar documentos',
Expand Down
9 changes: 9 additions & 0 deletions .vitepress/template/pt/translate.prompt
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# 翻译成 Português

## <File.Path>

````
<File.Tranlated_Content>
````

注意用四个````来保证不被内容的代码行破坏格式
25 changes: 25 additions & 0 deletions .vitepress/template/pt/translate_tutorial.prompt
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# 四份文件,翻译成 Português,单份文件格式:

## <File.Path>

````
<File.Tranlated_Content>
````

注意用四个````来保证不被内容的代码行破坏格式

## Step-n Template

文件与解释:

- _hint/App/template.md: 用户点击看答案后,小考题的答案
- _hint/description.md:用户点击看答案后,更新了一些介绍
- App/template.md:用户可交互的 Markdown 文本,有一些小考题
- description.md:一段介绍

注意

- App/template.md问题有引导性

- _hint/App/template.md的回答与App/template.md一一对应
- `_hint/description.md`会给出额外解释
9 changes: 4 additions & 5 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ layout: home

hero:
name: "Markdown Can Do It!"
text: "Escape the hassle of Word and HTML formatting"
tagline: Easy to use, efficient, plain text, multifunctional, AI-friendly
tagline: Escape the hassle of Word and HTML formatting
actions:
- theme: brand
text: Experience Now
Expand All @@ -17,19 +16,19 @@ features:
- icon: 📚
title: Tutorials
details: "Step by step, teach you how to use Markdown"
link: '/tutorial/'
link: /tutorial/
linkText: 'Click to View'
target: '_self'
- icon: 🛠️
title: Experience Multiple Functions Now
details: "Go beyond basic formatting, easily create flowcharts, Gantt charts, presentations (PPT), etc."
link: '/playground/'
link: /playground/
linkText: 'Explore Now'
target: '_self'
- icon: 🔍
title: More
details: "Explore more features of Markdown, including useful external links. Please choose as needed."
link: '/reference/resource'
link: /reference/resource
linkText: 'Discover More'
target: '_self'
---
98 changes: 98 additions & 0 deletions pt/guide/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
# O que o Markdown Pode Fazer

Markdown torna a formatação mais fácil. [Link do Playground](/playground/), [Link da página da web](/guide/).

> Playground não salvará sua alteração.
## O que Especificamente Ele Pode Fazer?

- [x] Implementar uma lista de tarefas simples
- [x] Formatos comuns de parágrafo: parágrafos normais, seis níveis de títulos, citações em bloco, listas, tarefas, código, tabelas, fórmulas, notas de rodapé, divisores, imagens, etc.
- [x] Formatos inline comuns: **negrito**, *itálico*, ~~tachado~~, [link🔗](), 🤣emoji, fórmula inline $e^\pi$, código inline `a = 3`...
- [ ] ~~Pegar algumas batatas fritas no cais~~

## Markdown Pode Fazer Mais

- [x] Vários gráficos, como fluxogramas, mapas mentais, gráficos de Gantt, linhas do tempo, etc. Acha isso problemático? Tente [deixar o ChatGPT fazer isso](/reference/chatgpt/).[^1]
- [ ] PPT
- [x] Partituras musicais (geralmente não suportadas por aplicativos Markdown)
- [x] Este site, veja a seção [Construindo um Site](#construindo-um-site)
- [ ] ~~Ir para Marte~~

### Linha do Tempo

```mermaid
timeline
title Linha do Tempo do Desenvolvimento do ChatGPT
section Desenvolvimento Inicial
30 de Novembro de 2022 : ChatGPT lançado, OpenAI
section Crescimento Rápido
Janeiro de 2023 : Mais de 100 milhões de usuários
section Atualização da Versão
14 de Março de 2023 : GPT-4 lançado, disponível para usuários do ChatGPT Plus
```

### Fluxograma

```mermaid
flowchart LR
A(("Pergunta")) --> B(Amigo)
A --> ChatGPT(ChatGPT)
B --> sum((Resumo))
ChatGPT --> sum
sum --> solucao(Solução)
solucao --> acumu((Acumulação))
acumu -->|Em grandes quantidades| Riqueza[(Riqueza)]
acumu -->|Ao longo de um tempo| Riqueza
```
### Partitura Musical

> Escrito pelo ChatGPT, pode estar errado.
```abc
X:1
T:Ode à Alegria
C:Ludwig van Beethoven
M:4/4
L:1/4
K:C
"G"G3/2A/2 G E G | "D7"F3/2E/2 F D F | "G"G3G G A | B3/2A/2 G E G |
"D7"F3/2E/2 F E D | "G"G3G G A | B3/2A/2 G E G | "D7"F3/2E/2 F D F | "G"G3z ||
```

## Mais Coisas Se Você For um Programador

### HTML

- <u>Sublinhado</u>
- iframe
- svg
- Criar um botão

### CSS

Markdown acaba renderizando como HTML, e CSS pode modificar o layout dos elementos HTML. Se o seu software de edição Markdown tem a configuração correspondente, você pode ser capaz de:

- Definir CSS inline
- Personalizar CSS globalmente

### Construindo um Site

Você pode implantar este site clicando neste botão:

[![Implantar Com Vercel](https://vercel.com/button

)](https://vercel.com/import/project?template=https://github.com/gantrol/markdown-can-do)

Existem muitas maneiras de construir sites baseados em Markdown. Pesquisas pessoais identificaram principalmente Vitepress e MDX como duas opções, ambas extendendo Markdown e permitindo a inserção de componentes de código. Vitepress suporta principalmente componentes Vue, enquanto MDX suporta principalmente componentes React.

Considerando desempenho e estabilidade de manutenção, este site é construído com Vitepress, e o dono do site aprendeu Vue da noite para o dia (~~em uma hora~~).

## Quer Mais?

Você pode querer conferir os [materiais de referência](/reference/resource) ou perguntar ao ChatGPT?

![ChatGPT](https://img.shields.io/badge/chatGPT-74aa9c?style=for-the-badge&logo=openai&logoColor=white)

[^1]: Acha difícil? Na verdade, não há necessidade de memorizar a sintaxe para vários gráficos. O proprietário do site costumava depender de manuais, mas agora consulta principalmente o ChatGPT.
9 changes: 9 additions & 0 deletions pt/guide/what-is-markdown.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# O que é Markdown?

Uma linguagem de marcação (ML), usada para formatação.

Ela pode ser convertida para HTML, formatando assim páginas da web. Quase permite focar no conteúdo sem se preocupar com o formato.

Para programadores, esta linguagem é fácil de usar e eficiente. Anteriormente, era popular entre programadores e comumente usada para escrever documentação. Documentos em Markdown podem ser ditos como amplamente difundidos no Github (a maior plataforma do mundo para programadores "socializarem").

Gradualmente, alguns aplicativos em inglês suportaram alguns formatos de Markdown em variados graus, incluindo Reddit, Discord, ChatGPT, Claude...
62 changes: 35 additions & 27 deletions pt/index.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,35 @@
# Por que Markdown?

Você já viu alguém usando espaços e quebras de linha para formatar um documento do Word? Quando é necessário indentar o início de um parágrafo, pressionam-se algumas vezes a tecla de espaço, e para ajustar o espaçamento entre linhas, pressiona-se várias vezes a tecla Enter...

Quantas pessoas você acha que usam os títulos de 1 a 6 no Word, e quantas delas modificam o estilo desses títulos?

Se seu colega ou subordinado gastasse muito tempo com a "formatação por espaços", o que você faria? Você ensinaria pessoalmente, contrataria alguém para treiná-los, ou simplesmente os demitiria e contrataria outro?

Em muitos cenários, a formatação com Markdown é de fato muito simples. Com apenas uma dúzia de símbolos comuns, é possível tornar-se um "programador Markdown" em meia hora.

Claro, para cenários de edição mais complexos, especialmente quando é necessário um controle preciso do layout das imagens, não se recomenda o uso de Markdown. (Embora a formatação de imagens no Word também seja bastante complicada)

Ele é um formato de texto puro, o que significa que você pode facilmente ajustar o texto Markdown existente com a ajuda de IA. De fato, as respostas do ChatGPT são formatadas em Markdown.

Além disso, você já pensou em usar o Word para criar diagramas de fluxo, apresentações de PowerPoint ou mapas mentais? Com Markdown você pode! E ainda é em texto puro - você pode deixar a IA desenhar essas coisas para você.

Muitos programadores gostam tanto do Markdown que desenvolveram funcionalidades surpreendentes com ele. Também é possível criar TODOs, e-mails, currículos, PDFs, layout para publicações em redes sociais...

Se você é um programador, então é provável que prefira Markdown (em comparação com HTML).

Se realmente não gostar, tudo bem, ~~porque você não tem escolha (Github, Reddit, Wikipedia...)~~.

Markdown pode ser usado para simplificar a formatação de HTML, e atualmente muitos frameworks usam Markdown para gerar páginas web diretamente.

Isso significa que os administradores do site podem não escrever código, apenas conteúdo.

E este site, exceto por um ["campo de prática" de experiência imediata](/zh/playground/) como esse, não requer escrita de código.
---
layout: home

hero:
name: "Markdown Pode Fazer Isso!"
tagline: Fuja do incômodo da formatação do Word e HTML
actions:
- theme: brand
text: Experimente Agora
link: /pt/playground/
- theme: alt
text: Por Que Usar?
link: /pt/guide/why

features:
- icon: 📚
title: Tutoriais
details: "Passo a passo, ensinamos como usar o Markdown"
link: /pt/tutorial/
linkText: 'Clique para Visualizar'
target: '_self'
- icon: 🛠️
title: Experimente Múltiplas Funções Agora
details: "Vá além da formatação básica, crie facilmente fluxogramas, gráficos de Gantt, apresentações (PPT), etc."
link: /pt/playground/
linkText: 'Explore Agora'
target: '_self'
- icon: 🔍
title: Mais
details: "Explore mais recursos do Markdown, incluindo links externos úteis. Por favor, escolha conforme a necessidade."
link: /pt/reference/resource
linkText: 'Descubra Mais'
target: '_self'

---
3 changes: 1 addition & 2 deletions zh/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,7 @@ layout: home

hero:
name: "Markdown 能做!"
text: "摆脱烦人的 Word 和 HTML 排版"
tagline: 易用、高效、纯文本、多功能、AI 友好
tagline: 摆脱烦人的 Word 和 HTML 排版
actions:
- theme: brand
text: 即刻体验
Expand Down

0 comments on commit ae01813

Please sign in to comment.