diff --git a/docs/README.cn.zh.md b/docs/README.cn.zh.md index b7868e8..44f1145 100644 --- a/docs/README.cn.zh.md +++ b/docs/README.cn.zh.md @@ -1,32 +1,110 @@ -
- -[![All Contributors](https://img.shields.io/badge/all_contributors-63-orange.svg?style=flat-square)](#contributors-) -[![styled with prettier](https://img.shields.io/badge/styled_with-prettier-ff69b4.svg)](https://github.com/prettier/prettier) -[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com) -[![MIT License](https://img.shields.io/github/license/carbon-app/carbon.svg)](https://github.com/carbon-app/carbon/blob/master/LICENSE) -[![Greenkeeper badge](https://badges.greenkeeper.io/carbon-app/carbon.svg)](https://greenkeeper.io/) -[![Join the community on Spectrum](https://withspectrum.github.io/badge/badge.svg)](https://spectrum.chat/carbon-now) ++ +
+ + + + ++ Español + | ++ हिंदी + | ++ Deutsch + | ++ 简体中文 + | ++ Português + | ++ മലയാളം + | ++ Türkçe + | +
+ 한국어 + | ++ தமிழ் + | ++ Français + | ++ 日本語 + | ++ Svenska + | ++ Add + + | ++ |
+ +
-## 示例 +## 特性 - +- **定制化**:定制选项包括图片的语法主题、窗口样式等 +- **快速分享**:一键生成图片并分享 +- **从 GitHub gist 导入**:只需要在 url 后面加上 GitHub gist id ## 使用 @@ -34,62 +112,118 @@ 有几种不同的方法可以将代码导入到 Carbon: -- 把文件拖到编辑器 -- 在 carbon url 后添加 GitHub gist id(比如 `carbon.now.sh/你的gist id`) +- 把文件拖放到编辑器中 +- 在 carbon url 后面添加 GitHub gist id (比如 `carbon.now.sh/你的_gist_id`) - 直接粘贴代码 #### 定制化 -当你把代码导入到 Carbon 后,你可以定制生成的代码图片。可定制的内容有语法主题,背景颜色,窗口主题,或者 padding 距离。 +当你把代码导入到 Carbon 后,你可以定制生成的代码图片。定制选项包括语法主题、背景颜色、窗口主题、以及 padding 距离。 #### 导出/分享 当你定制完图片样式后,可以分享到推特上面,或者直接保存。 +如果你通过 "Tweet" 按钮分享,Carbon 将自动设置你的图片为公开访问。不过如果你想手动分享图片,可以查看 [如何设置 Twitter 图片公开访问](https://help.twitter.com/en/using-twitter/picture-descriptions)。 + +如果你在文章中添加 Carbon 图片,注意到图片中的源代码对于无障碍技术来说是不可见的,比如无法放大字号或复制。可以考虑新增一个元素展示文本形式的源代码,比如在图片下方加一个 [详细信息展现元素](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/details)。 + +#### 安装 Carbon 桌面客户端(离线) + +如果你使用的是 Google Chrome 或别的支持 PWA 技术的浏览器,你可以安装 Carbon 并离线使用: + +1. 访问 [https://carbon.now.sh](https://carbon.now.sh) +2. 点击浏览器的设置按钮 +3. 点击 "安装 Carbon..." + ## 社区 -下面是我们社区已经创建的一些优秀的项目: +浏览社区中的这些优秀项目: ##### 编辑器插件 -- [IntelliJ IDEA `carbon-now-sh`](https://plugins.jetbrains.com/plugin/10469-carbon-now-sh) - 在 IntelliJ IDEA 中选中当前文件的一段代码到 Carbon 中 -- [Atom `carbon-now-sh`](https://atom.io/packages/carbon-now-sh) - 用`shift-cmd-A`命令在 Carbon 中导入你当前的 Atom 文件 -- [VS Code `carbon-now-sh`](https://marketplace.visualstudio.com/items?itemName=ericadamski.carbon-now-sh) - 用`carbon`命令在 Carbon 中导入你当前的 VS Code 文件 -- [Sublime Text 3 `carbon-now-sh`](https://github.com/molnarmark/carbonSublime) - 在 Sublime Text3 中选中当前文件的一段代码到 Carbon 中 -- [Vim `carbon-now-sh`](https://github.com/kristijanhusak/vim-carbon-now-sh) - 用`CarbonNowSh()`函数在 Carbon 中导入你当前的 Vim/Neovim 文件 -- [Emacs `carbon-now-sh`](https://github.com/veelenga/carbon-now-sh.el) - 用交互式函数`carbon-now-sh`在 Carbon 中导入你当前的 Emacs 文件 +- [IntelliJ IDEA `carbon-now-sh`](https://plugins.jetbrains.com/plugin/10469-carbon-now-sh) - 在 IntelliJ IDEA 中通过右键菜单导入选中的代码到 Carbon +- [Atom `carbon-now-sh`](https://atom.io/packages/carbon-now-sh) - 在 Atom 中通过 `shift-cmd-A` 快捷键导入当前文件到 Carbon +- [VS Code `carbon-now-sh`](https://marketplace.visualstudio.com/items?itemName=ericadamski.carbon-now-sh) - 在 VS Code 中通过 `carbon` 命令导入当前文件到 Carbon +- [Sublime Text 3 `carbon-now-sh`](https://github.com/molnarmark/carbonSublime) - 在 Sublime Text 3 中通过自定义快捷键导入选中的代码到 Carbon +- [Vim `carbon-now-sh`](https://github.com/kristijanhusak/vim-carbon-now-sh) - 在 Vim/Neovim 中通过 `CarbonNowSh()` 函数导入选中的代码到 Carbon +- [Emacs `carbon-now-sh`](https://github.com/veelenga/carbon-now-sh.el) - 在 Emacs 中通过 `carbon-now-sh` 交互函数导入选中的代码到 Carbon +- [Xcode `carbon-now-sh`](https://github.com/StevenMagdy/CarboNow4Xcode) - 在 `carbon.now.sh` 中打开选中的代码 +- [Xcode `nef`](https://github.com/bow-swift/nef-plugin) - 这个 Xcode 扩展程序能让你将选中的代码一键导出成 Carbon 片段 -##### 命令行工具 +##### 工具 -- [CLI `carbon-now-cli`](https://github.com/mixn/carbon-now-cli) - 在 Carbon 中打开一个文件或者直接使用`carbon-now`下载它,特色是交互式模式,可选高亮等 +- [CLI `carbon-now-cli`](https://github.com/mixn/carbon-now-cli) - 用 `carbon-now` 命令在 Carbon 中打开一个文件或者直接下载它,包含交互式选项、可选高亮等功能 +- [Carbonize](https://itunes.apple.com/us/app/carbonize/id1451177988) - 一个封装并扩展了原生功能的 macOS 程序 +- [CodeExpander](https://codeexpander.com) - 是一个智能并具有像 TextExpander 特性的 GitHub Gist 客户端 +- [`nef`](https://github.com/bow-swift/nef#-exporting-carbon-code-snippets) - 从 `Xcode Playground` 导出多个 Carbon 代码片段。 -##### Libraries +##### 库 -- [R `carbonate`](https://yonicd.github.io/carbonate/) - 迭代式处理`R`中的图片并在 Carbon 中打开,或者直接下载。 +- [R `carbonate`](https://yonicd.github.io/carbonate/) - 用 `R` 脚本迭代处理图片样式并在 Carbon 中打开或直接下载。 ##### 书籍 - ["CS 101 - An Introduction to Computational Thinking"](https://itunes.apple.com/us/book/id1435714196) - Sarbo Roy 写的一本计算机科学书. +## 项目作者 + +Carbon 项目由 TA 们发起: + +- Mike Fix ([@mfix22](https://github.com/mfix22)) +- Brian Dennis ([@briandennis](https://github.com/briandennis)) +- Jake Dexheimer ([@jakedex](https://github.com/jakedex)) + +#### License + +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fcarbon-app%2Fcarbon?ref=badge_large) + +