From ae018131c2b37263154470cb4854684401af92f9 Mon Sep 17 00:00:00 2001 From: "gantrol.q" <501963347@qq.com> Date: Sun, 17 Mar 2024 22:36:55 +0800 Subject: [PATCH] Add Portuguese translation for website content 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. --- .vitepress/config/index.ts | 2 +- .vitepress/config/pt.ts | 101 ++++++++++++++++-- .vitepress/template/pt/translate.prompt | 9 ++ .../template/pt/translate_tutorial.prompt | 25 +++++ index.md | 9 +- pt/guide/index.md | 98 +++++++++++++++++ pt/guide/what-is-markdown.md | 9 ++ pt/index.md | 62 ++++++----- zh/index.md | 3 +- 9 files changed, 273 insertions(+), 45 deletions(-) create mode 100644 .vitepress/template/pt/translate.prompt create mode 100644 .vitepress/template/pt/translate_tutorial.prompt create mode 100644 pt/guide/index.md create mode 100644 pt/guide/what-is-markdown.md diff --git a/.vitepress/config/index.ts b/.vitepress/config/index.ts index 9a349b5..593306b 100644 --- a/.vitepress/config/index.ts +++ b/.vitepress/config/index.ts @@ -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 }, } }) ) diff --git a/.vitepress/config/pt.ts b/.vitepress/config/pt.ts index ac7666f..cbf97ea 100644 --- a/.vitepress/config/pt.ts +++ b/.vitepress/config/pt.ts @@ -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: { @@ -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` }, @@ -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', diff --git a/.vitepress/template/pt/translate.prompt b/.vitepress/template/pt/translate.prompt new file mode 100644 index 0000000..616b92a --- /dev/null +++ b/.vitepress/template/pt/translate.prompt @@ -0,0 +1,9 @@ +# 翻译成 Português + +## + +```` + +```` + +注意用四个````来保证不被内容的代码行破坏格式 diff --git a/.vitepress/template/pt/translate_tutorial.prompt b/.vitepress/template/pt/translate_tutorial.prompt new file mode 100644 index 0000000..1497b15 --- /dev/null +++ b/.vitepress/template/pt/translate_tutorial.prompt @@ -0,0 +1,25 @@ +# 四份文件，翻译成 Português，单份文件格式： + +## + +```` + +```` + +注意用四个````来保证不被内容的代码行破坏格式 + +## 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`会给出额外解释 diff --git a/index.md b/index.md index 836e08c..10cb0a5 100644 --- a/index.md +++ b/index.md @@ -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 @@ -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' --- diff --git a/pt/guide/index.md b/pt/guide/index.md new file mode 100644 index 0000000..3ab6f8a --- /dev/null +++ b/pt/guide/index.md @@ -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 + +- Sublinhado +- 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. diff --git a/pt/guide/what-is-markdown.md b/pt/guide/what-is-markdown.md new file mode 100644 index 0000000..1cbc73e --- /dev/null +++ b/pt/guide/what-is-markdown.md @@ -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... diff --git a/pt/index.md b/pt/index.md index 37a1082..51e524b 100644 --- a/pt/index.md +++ b/pt/index.md @@ -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' + +--- diff --git a/zh/index.md b/zh/index.md index ed6e7da..460a051 100644 --- a/zh/index.md +++ b/zh/index.md @@ -3,8 +3,7 @@ layout: home hero: name: "Markdown 能做！" - text: "摆脱烦人的 Word 和 HTML 排版" - tagline: 易用、高效、纯文本、多功能、AI 友好 + tagline: 摆脱烦人的 Word 和 HTML 排版 actions: - theme: brand text: 即刻体验