mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-02-28 01:01:09 +08:00
Merge remote-tracking branch 'LCTT/master'
This commit is contained in:
commit
2f5670f751
@ -23,7 +23,7 @@ Ubuntu 麒麟的外观和感觉很像 Ubuntu 的现代版本。它拥有的 [Uni
|
||||
via: http://thevarguy.com/open-source-application-software-companies/091515/ubuntu-linux-based-open-source-os-runs-42-percent-dell-pc
|
||||
|
||||
作者:[Christopher Tozzi][a]
|
||||
译者:[geekpi](https://github.com/geeekpi)
|
||||
译者:[geekpi](https://github.com/geekpi)
|
||||
校对:[wxy](https://github.com/wxy)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创翻译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
@ -1,65 +1,69 @@
|
||||
Git 分支操作介绍
|
||||
======
|
||||
|
||||
> 在这个 Git 入门系列的第三篇中,我们来学习一下如何添加和删除 Git 分支。
|
||||
|
||||

|
||||
|
||||
在本系列的前两篇文章中,我们[开始使用 Git][1],学会如何[克隆项目,修改、增加和删除内容][2]。在这第三篇文章中,我将介绍 Git 分支,为何以及如何使用分支。
|
||||
|
||||
![树枝][3]
|
||||
|
||||
不妨用树来描绘 Git 仓库。图中的树有很多分支,或长或短,或从树干延伸或从其它分支延伸。在这里,我们用树干比作仓库的 master 分支,其中 `master` 代指 ”master branch",Git 仓库的中心分支或第一个分支。为简单起见,我们假设 `master` 是树干,其它分支都是从该分支分出的。
|
||||
不妨用树来描绘 Git 仓库。图中的树有很多分支,或长或短,或从树干延伸或从其它分支延伸。在这里,我们用树干比作仓库的 master 分支,其中 `master` 代指 ”master 分支”,是 Git 仓库的中心分支或第一个分支。为简单起见,我们假设 `master` 是树干,其它分支都是从该分支分出的。
|
||||
|
||||
### 为何在 Git 仓库中使用分支
|
||||
|
||||
* 如果你希望为项目增加新特性,但很可能会影响当前可正常工作的代码。对于项目的活跃用户而言,这是很糟糕的事情。与其将特性加入到其它人正在使用的 `master` 分支,更好的方法是在仓库的其它分支中变更代码,下面给出具体的工作方式。
|
||||
* 更重要的是,[Git 被设计][4]用于协作。如果所有人都在你代码仓库的 `master` 分支上操作,会引发很多混乱。对编程语言或项目的知识和阅历因人而异;有些人可能编写有错误或缺陷的代码,也可能编写你觉得不适合该项目的代码。使用分支可以让你核验他人的贡献并选择适合的加入到项目中。(这里假设你是代码库唯一的所有者,希望对增加到项目中的代码有完全的控制。在真实的项目中,代码库有多个具有合并代码权限的所有者)
|
||||
使用分支的主要理由为:
|
||||
|
||||
* 如果你希望为项目增加新特性,但很可能会影响当前可正常工作的代码。对于该项目的活跃用户而言,这是很糟糕的事情。与其将特性加入到其它人正在使用的 `master` 分支,更好的方法是在仓库的其它分支中变更代码,下面会给出具体的工作方式。
|
||||
* 更重要的是,[Git 其设计][4]用于协作。如果所有人都在你代码仓库的 `master` 分支上操作,会引发很多混乱。对编程语言或项目的知识和阅历因人而异;有些人可能会编写有错误或缺陷的代码,也可能会编写你觉得不适合该项目的代码。使用分支可以让你核验他人的贡献并选择适合的加入到项目中。(这里假设你是代码库唯一的所有者,希望对增加到项目中的代码有完全的控制。在真实的项目中,代码库有多个具有合并代码权限的所有者)
|
||||
|
||||
### 创建分支
|
||||
|
||||
使用分支的主要理由为:
|
||||
|
||||
让我们回顾[本系列上一篇文章][2],看一下在我们的 Demo 目录中分支是怎样的。如果你没有完成上述操作,请按照文章中的指示从 GitHub 克隆代码并进入 Demo 目录。运行如下命令:
|
||||
|
||||
```
|
||||
pwd
|
||||
git branch
|
||||
ls -la
|
||||
```
|
||||
|
||||
`pwd` 命令(是当前工作目录的英文缩写)返回当前你所处的目录(以便确认你在 Demo 目录中),`git branch` 列出 Demo 项目在你主机上的全部分支,`ls -la` 列出当前目录下的所有文件。你的终端输出类似于:
|
||||
`pwd` 命令(是当前工作目录的英文缩写)返回当前你所处的目录(以便确认你在 `Demo` 目录中),`git branch` 列出该项目在你主机上的全部分支,`ls -la` 列出当前目录下的所有文件。你的终端输出类似于:
|
||||
|
||||
![终端输出][5]
|
||||
|
||||
在 master 分支中,只有一个文件 `README.md`。(Git 会友好地忽略掉其它目录和文件。)
|
||||
在 `master` 分支中,只有一个文件 `README.md`。(Git 会友好地忽略掉其它目录和文件。)
|
||||
|
||||
接下来,运行如下命令:
|
||||
|
||||
```
|
||||
git status
|
||||
git checkout -b myBranch
|
||||
git status
|
||||
|
||||
```
|
||||
|
||||
第一条命令 `git status` 告知你当前处于 `branch master`,(就像在终端中看到的那样)与 `origin/master` 处于同步状态,意味着 master 分支本地副本中的全部文件也出现在 GitHub 中。两份副本没有差异,所有的提交也是一致的。
|
||||
第一条命令 `git status` 告知你当前位于 `branch master`,(就像在终端中看到的那样)它与 `origin/master` 处于同步状态,这意味着 master 分支的本地副本中的全部文件也出现在 GitHub 中。两份副本没有差异,所有的提交也是一致的。
|
||||
|
||||
下一条命令 `git checkout -b myBranch` 中的 `-b` 告知 Git 创建一个名为 `myBranch` 的新分支,然后 `checkout` 将我们切换到新创建的分支。运行第三条命令 `git status` 确保你已经位于刚创建的分支下。
|
||||
下一条命令 `git checkout -b myBranch` 中的 `-b` 告知 Git 创建一个名为 `myBranch` 的新分支,然后 `checkout` 命令将我们切换到新创建的分支。运行第三条命令 `git status` 确保你已经位于刚创建的分支下。
|
||||
|
||||
如你所见,`git status` 告知你当前处于 `myBranch` 分支,没有变更需要提交。这是因为我们既没有增加新文件,也没有修改已有文件。
|
||||
|
||||
![终端输出][6]
|
||||
|
||||
如果希望以可视化的方式查看分支,可以运行 `gitk` 命令。如果遇到报错 `bash: gitk: command not found…`,请先安装 `gitk` 软件包(找到你操作系统对应的安装文档,以获得安装方式)。
|
||||
如果希望以可视化的方式查看分支,可以运行 `gitk` 命令。如果遇到报错 `bash: gitk: command not found...`,请先安装 `gitk` 软件包(找到你操作系统对应的安装文档,以获得安装方式)。
|
||||
|
||||
(LCTT 译注:需要在有 X 服务器的终端运行 `gitk`,否则会报错)
|
||||
|
||||
下图展示了我们在 Demo 项目中的所作所为:你最后一次提交(对应的信息)是 `Delete file.txt`,在此之前有三次提交。当前的提交用黄点标注,之前的提交用蓝点标注,黄点和 `Delete file.txt` 之间的三个方块展示每个分支所在的位置(或者说每个分支中的最后一次提交的位置)。由于 `myBranch` 刚创建,提交状态与 `master` 分支及其对应的记为 `remotes/origin/master` 的远程 `master` 分支保持一致。(非常感谢来自 Red Hat 的 [Peter Savage][7] 让我知道 `gitk` 这个工具)
|
||||
下图展示了我们在 Demo 项目中的所作所为:你最后一次提交(的对应信息)是 `Delete file.txt`,在此之前有三次提交。当前的提交用黄点标注,之前的提交用蓝点标注,黄点和 `Delete file.txt` 之间的三个方块展示每个分支所在的位置(或者说每个分支中的最后一次提交的位置)。由于 `myBranch` 刚创建,提交状态与 `master` 分支及其对应的记为 `remotes/origin/master` 的远程 `master` 分支保持一致。(非常感谢来自 Red Hat 的 [Peter Savage][7] 让我知道 `gitk` 这个工具)
|
||||
|
||||
![Gitk 输出][8]
|
||||
|
||||
下面让我们在 `myBranch` 分支下创建一个新文件并观察终端输出。运行如下命令:
|
||||
|
||||
```
|
||||
echo "Creating a newFile on myBranch" > newFile
|
||||
cat newFile
|
||||
git status
|
||||
|
||||
```
|
||||
|
||||
第一条命令中的 `echo` 创建了名为 `newFile` 的文件,接着 `cat newFile` 打印出文件内容,最后 `git status` 告知你我们 `myBranch` 分支的当前状态。在下面的终端输出中,Git 告知 `myBranch` 分支下有一个名为 `newFile` 的文件当前处于 `untracked` 状态。这表明我们没有让 Git 追踪发生在文件 `newFile` 上的变更。
|
||||
@ -67,11 +71,11 @@ git status
|
||||
![终端输出][9]
|
||||
|
||||
下一步是增加文件,提交变更并将 `newFile` 文件推送至 `myBranch` 分支(请回顾本系列上一篇文章获得更多细节)。
|
||||
|
||||
```
|
||||
git add newFile
|
||||
git commit -m "Adding newFile to myBranch"
|
||||
git push origin myBranch
|
||||
|
||||
```
|
||||
|
||||
在上述命令中,`push` 命令使用的分支参数为 `myBranch` 而不是 `master`。Git 添加 `newFile` 并将变更推送到你 GitHub 账号下的 Demo 仓库中,告知你在 GitHub 上创建了一个与你本地副本分支 `myBranch` 一样的新分支。终端输出截图给出了运行命令的细节及命令输出。
|
||||
@ -89,6 +93,7 @@ git push origin myBranch
|
||||
截至目前,我们有两个分支:一个是 `master` 分支,只有一个 `README.md` 文件;另一个是 `myBranch` 分支,有两个文件。
|
||||
|
||||
你已经知道如何创建分支了,下面我们再创建一个分支。输入如下命令:
|
||||
|
||||
```
|
||||
git checkout master
|
||||
git checkout -b myBranch2
|
||||
@ -96,7 +101,6 @@ touch newFile2
|
||||
git add newFile2
|
||||
git commit -m "Adding newFile2 to myBranch2"
|
||||
git push origin myBranch2
|
||||
|
||||
```
|
||||
|
||||
我不再给出终端输出,需要你自己尝试,但你可以在 [GitHub 代码库][13] 中验证你的结果。
|
||||
@ -105,27 +109,29 @@ git push origin myBranch2
|
||||
|
||||
由于我们增加了两个分支,下面删除其中的一个(`myBranch`),包括两步:
|
||||
|
||||
**1\. 删除本地分支** 你不能删除正在操作的分支,故切换到 `master` 分支 (或其它你希望保留的分支),命令及终端输出如下:
|
||||
1. **删除本地分支** 你不能删除正在操作的分支,故切换到 `master` 分支 (或其它你希望保留的分支),命令及终端输出如下:
|
||||
|
||||
`git branch` 可以列出可用的分支,使用 `checkout` 切换到 `master` 分支,然后使用 `git branch -D myBranch` 删除该分支。再次运行 `git branch` 检查是否只剩下两个分支(而不是三个)。
|
||||

|
||||
|
||||
**2\. 删除 GitHub 上的分支** 使用如下命令删除 `myBranch` 的远程分支:
|
||||
```
|
||||
`git branch` 可以列出可用的分支,使用 `checkout` 切换到 `master` 分支,然后使用 `git branch -D myBranch` 删除该分支。再次运行 `git branch` 检查是否只剩下两个分支(而不是三个)。
|
||||
|
||||
2. **删除 GitHub 上的分支** 使用如下命令删除 `myBranch` 的远程分支:
|
||||
|
||||
```
|
||||
git push origin :myBranch
|
||||
|
||||
```
|
||||
|
||||
![Terminal output][14]
|
||||
![Terminal output][14]
|
||||
|
||||
上面 `push` 命令中分支名称前面的冒号(`:`)告知 GitHub 删除分支。另一种写法为:
|
||||
|
||||
```
|
||||
git push -d origin myBranch
|
||||
|
||||
```
|
||||
|
||||
其中 `-d` (也可以用 `--delete`) 也用于告知 GitHub 删除你的分支。
|
||||
|
||||
我们学习了 Git 分支的使用,在本系列的下一篇文章中,我们将介绍如何执行 fetch 和 rebase 操作,对于多人同时的贡献的项目而言,这是很必须学会的。
|
||||
我们学习了 Git 分支的使用,在本系列的下一篇文章中,我们将介绍如何执行 `fetch` 和 `rebase` 操作,对于多人同时的贡献的项目而言,这是很必须学会的。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
@ -134,13 +140,13 @@ via: https://opensource.com/article/18/5/git-branching
|
||||
作者:[Kedar Vijay Kulkarni][a]
|
||||
选题:[lujun9972](https://github.com/lujun9972)
|
||||
译者:[pinewall](https://github.com/pinewall)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
校对:[wxy](https://github.com/wxy)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/kkulkarn
|
||||
[1]:https://opensource.com/article/18/1/step-step-guide-git
|
||||
[2]:https://opensource.com/article/18/2/how-clone-modify-add-delete-git-files
|
||||
[1]:https://linux.cn/article-9319-1.html
|
||||
[2]:https://linux.cn/article-9517-1.html
|
||||
[3]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/tree-branches.jpg?itok=bQGpa5Uc (tree branches)
|
||||
[4]:https://en.wikipedia.org/wiki/Git
|
||||
[5]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/u128651/gitbranching_terminal1.png?itok=ZcAzRdlR (Terminal output)
|
@ -1,81 +0,0 @@
|
||||
Translating by MjSeven
|
||||
|
||||
|
||||
Top Linux tools for writers
|
||||
======
|
||||
|
||||

|
||||
If you've read [my article about how I switched to Linux][1], then you know that I’m a superuser. I also stated that I’m not an “expert” on anything. That’s still fair to say. But I have learned many helpful things over the last several years, and I'd like to pass these tips along to other new Linux users.
|
||||
|
||||
Today, I’m going to discuss the tools I use when I write. I based my choices on three criteria:
|
||||
|
||||
1. My main writing tool must be compatible for any publisher when I submit stories or articles.
|
||||
2. The software must be quick and simple to use.
|
||||
3. Free is good.
|
||||
|
||||
|
||||
|
||||
There are some wonderful all-in-one free solutions, such as:
|
||||
|
||||
However, I tend to get lost and lose my train of thought when I'm trying to find information, so I opted to go with multiple applications that suit my needs. Also, I don’t want to be reliant on the internet in case service goes down. I set these programs up on my monitor so I can see them all at once.
|
||||
|
||||
Consider the following tools suggestions—everyone works differently, and you might find some other app that better fits the way you work. These tools are current to this writing:
|
||||
|
||||
### Word processor
|
||||
|
||||
[LibreOffice 6.0.1][2]. Until recently, I used [WPS][3], but font-rendering problems (Times New Roman was always in bold format) nixed it. The newest version of LibreOffice adapts to Microsoft Office very nicely, and the fact that it's open source ticks the box for me.
|
||||
|
||||
### Thesaurus
|
||||
|
||||
[Artha][4] gives you synonyms, antonyms, derivatives, and more. It’s clean-looking and fast. Type the word "fast," for example, and you'll get the dictionary definition as well as the other options listed above. Artha is a huge gift to the open source community, and more people should try it as it seems to be one of those obscure little programs. If you’re using Linux, install this application now. You won’t regret it.
|
||||
|
||||
### Note-taking
|
||||
|
||||
[Zim][5] touts itself as a desktop wiki, but it’s also the easiest multi-level note-taking app you’ll find anywhere. There are other, prettier note-taking programs available, but Zim is exactly what I need to manage my characters, locations, plots, and sub-plots.
|
||||
|
||||
### Submission tracking
|
||||
|
||||
I once used a proprietary piece of software called [FileMaker Pro][6], and it spoiled me. There are plenty of database applications out there, but in my opinion the easiest one to use is [Glom][7]. It suits my needs graphically, letting me enter information in a form rather than a table. In Glom, you create the form you need so you can see relevant information instantly (for me, digging through a spreadsheet table to find information is like dragging my eyeballs over shards of glass). Although Glom no longer appears to be in development, it remains relevant.
|
||||
|
||||
### Research
|
||||
|
||||
I’ve begun using [StartPage.com][8] as my default search engine. Sure, [Google][9] can be one of your best friends when you're writing. But I don't like how Google tracks me every time I want to learn about a specific person/place/thing. So I use StartPage.com instead; it's fast and does not track your searches. I also use [DuckDuckGo.com][10] as an alternative to Google.
|
||||
|
||||
### Other tools
|
||||
|
||||
[Chromium Browser][11] is an open source version of [Google Chrome][12], with privacy plugins.
|
||||
|
||||
Though [Thunderbird][13], from [Mozilla][14], is a great program, I find [Geary][15] a much quicker and lighter email app. For more on open source email apps, read [Jason Baker][16]'s excellent article, [Top 6 open source desktop email clients][17].
|
||||
|
||||
As you might have noticed, my taste in apps tends to merge the best of Windows, MacOS, and the open source Linux alternatives mentioned here. I hope these suggestions help you discover helpful new ways to compose (thank you, Artha!) and track your written works.
|
||||
|
||||
Happy writing!
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/18/3/top-Linux-tools-for-writers
|
||||
|
||||
作者:[Adam Worth][a]
|
||||
译者:[译者ID](https://github.com/译者ID)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/adamworth
|
||||
[1]:https://opensource.com/article/18/2/my-linux-story-Antergos
|
||||
[2]:https://www.libreoffice.org/
|
||||
[3]:http://wps-community.org/
|
||||
[4]:https://sourceforge.net/projects/artha/
|
||||
[5]:http://zim-wiki.org/
|
||||
[6]:http://www.filemaker.com/
|
||||
[7]:https://www.glom.org/
|
||||
[8]:https://www.startpage.com/
|
||||
[9]:https://www.google.com/
|
||||
[10]:https://duckduckgo.com/
|
||||
[11]:https://www.chromium.org/
|
||||
[12]:https://www.google.com/chrome/
|
||||
[13]:https://www.mozilla.org/en-US/thunderbird/
|
||||
[14]:https://www.mozilla.org/en-US/
|
||||
[15]:https://wiki.gnome.org/Apps/Geary
|
||||
[16]:https://opensource.com/users/jason-baker
|
||||
[17]:https://opensource.com/business/18/1/desktop-email-clients
|
@ -1,3 +1,6 @@
|
||||
Translating by MjSeven
|
||||
|
||||
|
||||
How To Downgrade A Package In Arch Linux
|
||||
======
|
||||
|
||||
|
@ -1,121 +0,0 @@
|
||||
translating---geeekpi
|
||||
|
||||
Analyzing Ansible runs using ARA
|
||||
======
|
||||
|
||||

|
||||
[Ansible][1] is a versatile platform that has become popular for managing servers and server configurations. Today, Ansible is used heavily to deploy and test through continuous integration (CI).
|
||||
|
||||
In the world of automated continuous integration, it’s not uncommon to have hundreds, if not thousands, of jobs running every day for testing, building, compiling, deploying, and more.
|
||||
|
||||
### The Ansible Run Analysis (ARA) tool
|
||||
|
||||
Ansible runs generate a large amount of console data, and keeping up with high volumes of Ansible output in the context of CI is challenging. The Ansible Run Analysis (ARA) tool makes this verbose output readable and more representative of the job status and debug information. ARA organizes recorded playbook data so you can search and find what you’re interested in as quickly and as easily as possible.
|
||||
|
||||
Note that ARA doesn't run your playbooks for you; rather, it integrates with Ansible as a callback plugin wherever it is. A callback plugin enables adding new behaviors to Ansible when responding to events. It can perform custom actions in response to Ansible events such as a play starting or a task completing on a host.
|
||||
|
||||
Compared to [AWX][2] and [Tower][3], which are tools that control the entire workflow, with features like inventory management, playbook execution, editing features, and more, the scope of ARA is comparatively narrow: It records data and provides an intuitive interface. It is a relatively simple application that is easy to install and configure.
|
||||
|
||||
#### Installation
|
||||
|
||||
There are two ways to install ARA on your system:
|
||||
|
||||
* Using the Ansible role hosted on your [GitHub account][4]. Clone the repo and do:
|
||||
|
||||
|
||||
```
|
||||
ansible-playbook Playbook.yml
|
||||
|
||||
```
|
||||
|
||||
If the playbook run is successful, you will get:
|
||||
```
|
||||
TASK [ara : Display ara UI URL] ************************
|
||||
|
||||
ok: [localhost] => {}
|
||||
|
||||
"msg": "Access playbook records at http://YOUR_IP:9191"
|
||||
|
||||
```
|
||||
|
||||
Note: It picks the IP address from `ansible_default_ipv4` fact gathered by Ansible. If there is no such fact gathered, replace it with your IP in `main.yml` file in the `roles/ara/tasks/` folder.
|
||||
|
||||
* ARA is an open source project available on [GitHub][5] under the Apache v2 license. Installation instructions are in the Quickstart chapter. The [documentation][6] and [FAQs][7] are available on [readthedocs.io][6].
|
||||
|
||||
|
||||
|
||||
#### What can ARA do?
|
||||
|
||||
The image below shows the ARA landing page launched from the browser:
|
||||
|
||||
|
||||
![ara landing page][9]
|
||||
|
||||
The ARA landing page
|
||||
|
||||
It provides summaries of task results per host or per playbook:
|
||||
|
||||
|
||||
![task summaries][11]
|
||||
|
||||
ARA displays task summaries
|
||||
|
||||
It allows you to filter task results by playbook, play, host, task, or status:
|
||||
|
||||
|
||||
![playbook runs filtered by hosts][13]
|
||||
|
||||
Playbook runs, filtered by host
|
||||
|
||||
With ARA, you can easily drill down from the summary view to find the results you’re interested in, whether it’s a particular host or a specific task:
|
||||
|
||||
|
||||
![summary of each task][15]
|
||||
|
||||
A detailed summary of each task
|
||||
|
||||
ARA supports recording and viewing multiple runs in the same database.
|
||||
|
||||
|
||||
![show gathered facts][17]
|
||||
|
||||
Displaying gathered facts
|
||||
|
||||
#### Wrapping up
|
||||
|
||||
ARA is a useful resource that has helped me get more out of Ansible run logs and outputs. I highly recommend it to all Ansible ninjas out there.
|
||||
|
||||
Feel free to share this, and please let me know about your experience using ARA in the comments.
|
||||
|
||||
**[See our related story,[Tips for success when getting started with Ansible][18].]**
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/18/5/analyzing-ansible-runs-using-ara
|
||||
|
||||
作者:[Ajinkya Bapat][a]
|
||||
选题:[lujun9972](https://github.com/lujun9972)
|
||||
译者:[译者ID](https://github.com/译者ID)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/iamajinkya
|
||||
[1]:https://www.ansible.com/
|
||||
[2]:https://www.ansible.com/products/awx-project
|
||||
[3]:https://www.ansible.com/products/tower
|
||||
[4]:https://github.com/AjinkyaBapat/Ansible-Run-Analyser
|
||||
[5]:https://github.com/dmsimard/ara
|
||||
[6]:http://ara.readthedocs.io/en/latest/
|
||||
[7]:http://ara.readthedocs.io/en/latest/faq.html
|
||||
[8]:/file/395716
|
||||
[9]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/ara_landing_page.png?itok=PoB7KfhB (ara landing page)
|
||||
[10]:/file/395726
|
||||
[11]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/task_summaries.png?itok=8EBP9sTG (task summaries)
|
||||
[12]:/file/395731
|
||||
[13]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/playbook_filtered_by_hosts.png?itok=Lol0K_My (playbook runs filtered by hosts)
|
||||
[14]:/file/395736
|
||||
[15]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/summary_of_each_task.png?itok=KJnLHEZC (summary of each task)
|
||||
[16]:/file/395741
|
||||
[17]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/showing_gathered_facts.png?itok=FVDc6oA0 (show gathered facts)
|
||||
[18]:/article/18/2/tips-success-when-getting-started-ansible
|
@ -1,121 +0,0 @@
|
||||
pinewall translating
|
||||
|
||||
4 Markdown-powered slide generators
|
||||
======
|
||||
|
||||

|
||||
|
||||
Imagine you've been tapped to give a presentation. As you're preparing your talk, you think, "I should whip up a few slides."
|
||||
|
||||
Maybe you prefer the simplicity of [plain text][1], or maybe you think software like LibreOffice Writer is overkill for what you need to do. Or perhaps you just want to embrace your inner geek.
|
||||
|
||||
It's easy to turn files formatted with [Markdown][2] into attractive presentation slides. Here are four tools that can do help you do the job.
|
||||
|
||||
### Landslide
|
||||
|
||||
One of the more flexible applications on this list, [Landslide][3] is a command-line application that takes files formatted with Markdown, [reStructuredText][4], or [Textile][5] and converts them into an HTML file based on [Google’s HTML5 slides template][6].
|
||||
|
||||
All you need to do is write up your slides with Markdown, crack open a terminal window, and run the command `landslide` followed by the name of the file. Landslide will spit out presentation.html, which you can open in any web browser. Simple, isn’t it?
|
||||
|
||||
Don't let that simplicity fool you. Landslide offers more than a few useful features, such as the ability to add notes and create configuration files for your slides. Why would you want to do that? According to Landslide's developer, it helps with aggregating and reusing source directories across presentations.
|
||||
|
||||
|
||||
![landslide.png][8]
|
||||
|
||||
Viewing presenter notes in a Landslide presentation
|
||||
|
||||
### Marp
|
||||
|
||||
[Marp][9] is a work in progress, but it shows promise. Short for "Markdown Presentation Writer," Marp is an [Electron][10] app in which you craft slides using a simple two-pane editor: Write in Markdown in the left pane and you get a preview in the right pane.
|
||||
|
||||
Marp supports [GitHub Flavored Markdown][11]. If you need a quick tutorial on using GitHub Flavored Markdown to write slides, check out the [sample presentation][12]. It's a bit more flexible than baseline Markdown.
|
||||
|
||||
While Marp comes with only two very basic themes, you can add background images to your slides, resize them, and include math. On the down side, it currently lets you export your slides only as PDF files. To be honest, I wonder why HTML export wasn’t a feature from day one.
|
||||
|
||||
|
||||
![marp.png][14]
|
||||
|
||||
Editing some simple slides in Marp
|
||||
|
||||
### Pandoc
|
||||
|
||||
You probably know [pandoc][15] as a magic wand for converting between various markup languages. What you might not know is that pandoc can take a file formatted with Markdown and create attractive HTML slides that work with the [Slidy][16], [Slideous][17], [DZSlides][18], [S5][19], and [Reveal.js][20] presentation frameworks. If you prefer [LaTeX][21], you can also output PDF slides using the [Beamer package][22].
|
||||
|
||||
You'll need to [use specific formatting][23] for your slides, but you can add some [variables][24] to control how they behave. You can also change the look and feel of your slides, add pauses between slides, and include speaker notes.
|
||||
|
||||
Of course, you must have the supporting files for your preferred presentation framework installed on your computer. Pandoc spits out only the raw slide file.
|
||||
|
||||
|
||||
![pandoc.png][26]
|
||||
|
||||
Viewing slides created with Pandoc and DZSlides
|
||||
|
||||
### Hacker Slides
|
||||
|
||||
[Hacker Slides][27] is an application for [Sandstorm][28] and [Sandstorm Oasis][29] that mates Markdown and the [Reveal.js][20] slide framework. The slides are simple, but they can be visually striking.
|
||||
|
||||
Craft your slide deck in a two-pane editor in your browser—type in Markdown on the left and see it rendered on the right. When you're ready to present, you can do it from within Sandstorm or get a link that you can share with others to present remotely.
|
||||
|
||||
What’s that—you say that you don’t use Sandstorm or Sandstorm Oasis? No worries.There's a [version of Hacker Slides][30] that you can run on your desktop or server.
|
||||
|
||||
|
||||
![hacker-slides.png][32]
|
||||
|
||||
Editing slides in Hacker Slides
|
||||
|
||||
### Two honorable mentions
|
||||
|
||||
If you use [Jupyter Notebooks][33] (see community moderator Don Watkins' [article][34]) to publish data or instructional texts, then [Jupyter2slides][35] is for you. It works with Reveal.js to convert a notebook into a nice set of HTML slides.
|
||||
|
||||
If you prefer your applications hosted, test-drive [GitPitch][36]. It works with GitHub, GitLab, and Bitbucket. Just push the source files for your slides to a repository on one of those services, point GitPitch to that repository, and your slides are ready to view at the GitPitch site.
|
||||
|
||||
Do you have a favorite Markdown-powered slide generator? Share it by leaving a comment.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/18/5/markdown-slide-generators
|
||||
|
||||
作者:[Scott Nesbitt][a]
|
||||
选题:[lujun9972](https://github.com/lujun9972)
|
||||
译者:[译者ID](https://github.com/译者ID)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/scottnesbitt
|
||||
[1]:https://plaintextproject.online/
|
||||
[2]:https://en.wikipedia.org/wiki/Markdown
|
||||
[3]:https://github.com/adamzap/landslide
|
||||
[4]:https://en.wikipedia.org/wiki/ReStructuredText
|
||||
[5]:https://en.wikipedia.org/wiki/Textile_(markup_language)
|
||||
[6]:https://github.com/skaegi/html5slides
|
||||
[7]:/file/397441
|
||||
[8]:https://opensource.com/sites/default/files/uploads/landslide.png (landslide.png)
|
||||
[9]:https://yhatt.github.io/marp/
|
||||
[10]:https://en.wikipedia.org/wiki/Electron_(software_framework)
|
||||
[11]:https://guides.github.com/features/mastering-markdown/
|
||||
[12]:https://raw.githubusercontent.com/yhatt/marp/master/example.md
|
||||
[13]:/file/397446
|
||||
[14]:https://opensource.com/sites/default/files/uploads/marp.png (marp.png)
|
||||
[15]:https://pandoc.org/
|
||||
[16]:https://www.w3.org/Talks/Tools/Slidy2/Overview.html#(1)
|
||||
[17]:http://goessner.net/articles/slideous/
|
||||
[18]:http://paulrouget.com/dzslides/
|
||||
[19]:https://meyerweb.com/eric/tools/s5/
|
||||
[20]:https://revealjs.com/#/
|
||||
[21]:https://www.latex-project.org/
|
||||
[22]:https://en.wikipedia.org/wiki/Beamer_(LaTeX)
|
||||
[23]:https://pandoc.org/MANUAL.html#producing-slide-shows-with-pandoc
|
||||
[24]:https://pandoc.org/MANUAL.html#variables-for-slides
|
||||
[25]:/file/397451
|
||||
[26]:https://opensource.com/sites/default/files/uploads/pandoc.png (pandoc.png)
|
||||
[27]:https://github.com/jacksingleton/hacker-slides
|
||||
[28]:https://sandstorm.io/
|
||||
[29]:https://oasis.sandstorm.io/
|
||||
[30]:https://github.com/msoedov/hacker-slides
|
||||
[31]:/file/397456
|
||||
[32]:https://opensource.com/sites/default/files/uploads/hacker-slides.png (hacker-slides.png)
|
||||
[33]:http://jupyter.org/
|
||||
[34]:https://opensource.com/article/18/3/getting-started-jupyter-notebooks
|
||||
[35]:https://github.com/datitran/jupyter2slides
|
||||
[36]:https://gitpitch.com/
|
@ -1,3 +1,5 @@
|
||||
heart4lor translating
|
||||
|
||||
How to Build an Amazon Echo with Raspberry Pi
|
||||
======
|
||||
|
||||
|
@ -1,3 +1,5 @@
|
||||
translating----geekpi
|
||||
|
||||
Vim-plug : A Minimalist Vim Plugin Manager
|
||||
======
|
||||
|
||||
|
@ -1,3 +1,5 @@
|
||||
pinewall translating
|
||||
|
||||
MySQL without the MySQL: An introduction to the MySQL Document Store
|
||||
======
|
||||
|
||||
|
84
translated/talk/20180323 Top Linux tools for writers.md
Normal file
84
translated/talk/20180323 Top Linux tools for writers.md
Normal file
@ -0,0 +1,84 @@
|
||||
献给写作者的 Linux 工具
|
||||
======
|
||||
|
||||

|
||||
如果你已经阅读过[我关于如何切换到 Linux 的文章][1],那么你就知道我是一个超级用户。另外,我不是任何方面的“专家”,这点仍然可以相信。但是在过去几年里我学到了很多有用的东西,我想将这些技巧传给其他新的 Linux 用户。
|
||||
|
||||
今天,我将讨论我写作时使用的工具,基于三个标准来选择:
|
||||
|
||||
1. 当我提交故事或文章时,我的主要写作工具必须与任何发布者兼容。
|
||||
2. 该软件使用起来必须简单快捷。
|
||||
3. 免费(自由)是很棒的。
|
||||
|
||||
有一些很棒的一体化免费解决方案,比如:
|
||||
|
||||
1. [bibisco][2]
|
||||
2. [Manuskript][3]
|
||||
3. [oStorybook][4]
|
||||
|
||||
|
||||
但是,当我试图寻找信息时,我往往会迷失方向并失去思路,所以我选择了适合我需求的多个应用程序。另外,如果服务停止的话,我不想依赖互联网。我在监视器上设置了这些程序,以便我可以马上看到它们。
|
||||
|
||||
请考虑以下工具建议 - 每个人的工作方式都不相同,并且你可能会发现一些更适合你工作方式的其他应用程序。这些工具是目前的写作工具:
|
||||
|
||||
### Word 处理器
|
||||
|
||||
[LibreOffice 6.0.1][5]。直到最近,我使用了 [WPS][6],但由于字体渲染问题(Times New Roman 总是以粗体显示)而否定了它。LibreOffice 的最新版本非常适合 Microsoft Office,事实上它是开源的,这对我来说很重要。
|
||||
|
||||
### 词库
|
||||
|
||||
[Artha][7] 可以给出同义词,反义词,派生词等等。它外观干净,速度快。例如,输入 “fast” 这个词,你会得到字典定义以及上面列出的其他选项。Artha 是送给开源社区的一个巨大的礼物,更多的人应该尝试它,因为它似乎是一个模糊(to 校正者:这里模糊一次感觉不太恰当,或许是不太出名的)的小程序。如果你使用 Linux,请立即安装此应用程序,你不会后悔的。
|
||||
|
||||
### 记笔记
|
||||
|
||||
[Zim][8] 标榜自己是一个桌面维基,但它也是你在任何地方都能找到的最简单的多层笔记应用程序。还有其它更漂亮的笔记程序,但 Zim 正是那种我需要管理角色,地点,情节和次要情节的程序。
|
||||
|
||||
### Submission tracking
|
||||
|
||||
我曾经使用过一款名为 [FileMaker Pro][9] 的专有软件,它让我心烦(to 校正者:这句话注意一下)。有很多数据库应用程序,但在我看来,最简单的一个就是 [Glom][10]。它以图形方式满足我的需求,让我以表单形式输入信息而不是表格。在 Glom 中,你可以创建你需要的表单,这样你就可以立即看到相关信息(对于我来说,通过电子表格来查找信息就像将我的眼球拖到玻璃碎片上)。尽管 Glom 不再处于开发阶段,但它仍然是很棒的。
|
||||
|
||||
### 搜索
|
||||
|
||||
我已经开始使用 [StartPage.com][11] 作为我的默认搜索引擎。当然,当你写作时,[Google][12] 可以成为你最好的朋友之一。但我不喜欢每次我想了解特定人物,地点或事物时,Google 都会跟踪我。所以我使用 StartPage.com 来代替。它速度很快,并且不会跟踪你的搜索。我也使用 [DuckDuckGo.com][13] 作为 Google 的替代品。
|
||||
|
||||
### 其他的工具
|
||||
|
||||
[Chromium 浏览器][14] 是 [Google Chrome][15] 的开源版本,带有隐私插件。
|
||||
|
||||
尽管来自 [Mozilla][17] 的 [Thunderbird][16] 是一个很棒的程序,但我发现 [Geary][18] 是一个更快更轻的电子邮件应用程序。有关开源电子邮件应用程序的更多信息,请阅读 [Jason Baker][19] 的优秀文章:[6 个开源的桌面电子邮件客户端][20]。
|
||||
|
||||
正如你可能已经注意到,我对应用程序的喜爱趋向于在 Windows,MacOS 都能运行(to 校正者:此处小心)以及此处提到的开源 Linux 替代品。我希望这些建议能帮助你发现有用的新方法来撰写并跟踪你的写作(谢谢你,Artha!)。
|
||||
|
||||
写作愉快!
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/18/3/top-Linux-tools-for-writers
|
||||
|
||||
作者:[Adam Worth][a]
|
||||
译者:[MjSeven](https://github.com/MjSeven)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/adamworth
|
||||
[1]:https://opensource.com/article/18/2/my-linux-story-Antergos
|
||||
[2]:http://www.bibisco.com/
|
||||
[3]:http://www.theologeek.ch/manuskript/
|
||||
[4]:http://ostorybook.tuxfamily.org/index.php?lng=en
|
||||
[5]:https://www.libreoffice.org/
|
||||
[6]:http://wps-community.org/
|
||||
[7]:https://sourceforge.net/projects/artha/
|
||||
[8]:http://zim-wiki.org/
|
||||
[9]:http://www.filemaker.com/
|
||||
[10]:https://www.glom.org/
|
||||
[11]:https://www.startpage.com/
|
||||
[12]:https://www.google.com/
|
||||
[13]:https://duckduckgo.com/
|
||||
[14]:https://www.chromium.org/
|
||||
[15]:https://www.google.com/chrome/
|
||||
[16]:https://www.mozilla.org/en-US/thunderbird/
|
||||
[17]:https://www.mozilla.org/en-US/
|
||||
[18]:https://wiki.gnome.org/Apps/Geary
|
||||
[19]:https://opensource.com/users/jason-baker
|
||||
[20]:https://opensource.com/business/18/1/desktop-email-clients
|
119
translated/tech/20180510 Analyzing Ansible runs using ARA.md
Normal file
119
translated/tech/20180510 Analyzing Ansible runs using ARA.md
Normal file
@ -0,0 +1,119 @@
|
||||
使用 ARA 分析 Ansible 运行
|
||||
======
|
||||
|
||||

|
||||
[Ansible][1] 是一个多功能平台,它已经成为管理服务器和服务器配置的流行平台。如今,Ansible 大量用于通过持续集成 (CI) 进行部署和测试。
|
||||
|
||||
在自动化持续集成的世界中,每天都有数百个甚至数千个作业运行测试、构建、编译、部署等等,这并不罕见。
|
||||
|
||||
### Ansible 运行分析 (ARA) 工具
|
||||
|
||||
Ansible 运行生成大量控制台数据,在 CI 的环境下跟上大量的 Ansible 输出是具有挑战性的。Ansible Run Analysis(ARA) 工具使此详细输出可读并且使作业状态和调试信息更有代表性。ARA 组织记录的 playbook 数据,以便你尽可能快速和容易地搜索并找到你感兴趣的内容。
|
||||
|
||||
请注意,ARA 不会运行你的 playbook。相反,无论在哪它都它作为回调插件与 Ansible 集成。回调插件可以在响应事件时向 Ansible 添加新行为。它可以根据 Ansible 事件执行自定义操作,例如在主机开始执行或任务完成时执行。
|
||||
|
||||
与 [AWX][2] 和 [Tower][3] 相比,它们是控制整个工作流程的工具,具有仓库管理、playbook 执行,编辑功能等功能,ARA 的范围相对较窄:记录数据并提供直观的界面。这是一个相对简单的程序,易于安装和配置。
|
||||
|
||||
#### 安装
|
||||
|
||||
在系统上安装 ARA 有两种方法:
|
||||
|
||||
* 使用托管在[ GitHub 帐户][4] 上的 Ansible 角色。克隆仓库并:
|
||||
|
||||
|
||||
```
|
||||
ansible-playbook Playbook.yml
|
||||
|
||||
```
|
||||
|
||||
如果 playbook 执行成功,你将看到:
|
||||
```
|
||||
TASK [ara : Display ara UI URL] ************************
|
||||
|
||||
ok: [localhost] => {}
|
||||
|
||||
"msg": "Access playbook records at http://YOUR_IP:9191"
|
||||
|
||||
```
|
||||
|
||||
注意:它从 Ansible 收集的 `ansible_default_ipv4` fact 中选择 IP 地址。如果没有收集这些 fact,请用 `roles/ara/tasks/` 文件夹中 `main.yml` 文件中的 IP 替换它。
|
||||
|
||||
* ARA 是一个在 [GitHub][5] 上以 Apache v2 许可证授权的开源项目。安装说明在快速入门章节。[文档][6]和 [FAQ][7] 可在 [readthedocs.io][6] 上找到。
|
||||
|
||||
|
||||
|
||||
#### ARA 能做些什么?
|
||||
|
||||
下图显示了从浏览器启动 ARA 登录页面:
|
||||
|
||||
|
||||
![ara landing page][9]
|
||||
|
||||
ARA 登录页面
|
||||
|
||||
它提供了每个主机或每个 playbook 的任务结果摘要:
|
||||
|
||||
|
||||
![task summaries][11]
|
||||
|
||||
ARA 显示任务摘要
|
||||
|
||||
它允许你通过 playbook,play,主机、任务或状态来过滤任务结果:
|
||||
|
||||
|
||||
![playbook runs filtered by hosts][13]
|
||||
|
||||
通过主机过滤 playbook 运行
|
||||
|
||||
借助 ARA,你可以在摘要视图中轻松查看你感兴趣的结果,无论是特定的主机还是特定的任务:
|
||||
|
||||
|
||||
![summary of each task][15]
|
||||
|
||||
每项任务的详细摘要
|
||||
|
||||
ARA 支持在同一数据库中记录和查看多个运行。
|
||||
|
||||
|
||||
![show gathered facts][17]
|
||||
|
||||
显示收集的 fact
|
||||
|
||||
#### 总结
|
||||
|
||||
ARA 是一个已经帮助我从 Ansible 运行日志和输出中了解更多的有用资源。我强烈推荐给所有的 Ansible 使用者。
|
||||
|
||||
请随意分享,并请在评论中告诉我你使用 ARA 的经历。
|
||||
|
||||
**[参见我们的相关文章,[成功使用 Ansible 的秘诀][18]]。**
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/18/5/analyzing-ansible-runs-using-ara
|
||||
|
||||
作者:[Ajinkya Bapat][a]
|
||||
选题:[lujun9972](https://github.com/lujun9972)
|
||||
译者:[geekpi](https://github.com/geekpi)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/iamajinkya
|
||||
[1]:https://www.ansible.com/
|
||||
[2]:https://www.ansible.com/products/awx-project
|
||||
[3]:https://www.ansible.com/products/tower
|
||||
[4]:https://github.com/AjinkyaBapat/Ansible-Run-Analyser
|
||||
[5]:https://github.com/dmsimard/ara
|
||||
[6]:http://ara.readthedocs.io/en/latest/
|
||||
[7]:http://ara.readthedocs.io/en/latest/faq.html
|
||||
[8]:/file/395716
|
||||
[9]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/ara_landing_page.png?itok=PoB7KfhB (ara landing page)
|
||||
[10]:/file/395726
|
||||
[11]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/task_summaries.png?itok=8EBP9sTG (task summaries)
|
||||
[12]:/file/395731
|
||||
[13]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/playbook_filtered_by_hosts.png?itok=Lol0K_My (playbook runs filtered by hosts)
|
||||
[14]:/file/395736
|
||||
[15]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/summary_of_each_task.png?itok=KJnLHEZC (summary of each task)
|
||||
[16]:/file/395741
|
||||
[17]:https://opensource.com/sites/default/files/styles/panopoly_image_original/public/images/life-uploads/showing_gathered_facts.png?itok=FVDc6oA0 (show gathered facts)
|
||||
[18]:/article/18/2/tips-success-when-getting-started-ansible
|
119
translated/tech/20180524 4 Markdown-powered slide generators.md
Normal file
119
translated/tech/20180524 4 Markdown-powered slide generators.md
Normal file
@ -0,0 +1,119 @@
|
||||
4 种基于 Markdown 的幻灯片生成器
|
||||
======
|
||||
|
||||

|
||||
|
||||
假设你需要做一个<ruby>演示<rt>presentation</rt></ruby>。在准备的过程中,你想到“我需要写几张幻灯片”。
|
||||
|
||||
你可能倾向于简洁的[纯文本][1],认为 LibreOffice Writer 这样的软件对你要做的事情而言像是杀鸡用牛刀。或者你只是遵从你内心深处的极客意识。
|
||||
|
||||
将 [Markdown][2] 格式的文件转换为优雅的演示幻灯片并不困难。下面介绍可以完成这项工作的四种工具。
|
||||
|
||||
### Landslide
|
||||
|
||||
在这些工具中,[Landslide][3] 具有更高的灵活性。它是一个命令行工具,可以将 Markdown、[reStructuredText][4] 或 [Textile][5] 格式的文件转换为基于 [Google HTML5 幻灯片模板][6]的 HTML 文件。
|
||||
|
||||
你要做的不过是编写 Markdown 格式的幻灯片源文件,打开一个终端窗口并运行 `landslide` 命令即可,其中命令参数为 Markdown 文件的文件名。Landslide 会生成 presentation.html,可以在任何 Web 浏览器中打开。简单吧?
|
||||
|
||||
但不要被简易的操作误导你。Landslide 提供了不少有用的特性,例如增加注记以及为幻灯片增加配置文件。为何要使用这些特性呢?按照 Landslide 开发者的说法,这样可以汇聚不同演示中的源文件目录并重用。
|
||||
|
||||
|
||||
![landslide.png][8]
|
||||
|
||||
在 Landslide 演示中查看演示者注记。
|
||||
|
||||
### Marp
|
||||
|
||||
[Marp][9] 仍处于开发中,但值得期待。它是 "Markdown Presentation Writer" 的简写。Marp 是一个基于 [Electron][10] 的工具,让你在一个简单的双栏编辑器中编写幻灯片:在左栏编写 Markdown,在右栏中预览效果。
|
||||
|
||||
Marp 支持 [GitHub 风格 Markdown][11]。如果你需要一个使用 GitHub 风格 Markdown 编写幻灯片的快速教程,可以参考 [示例项目][12]。GitHub 风格 Markdown 比基础 Markdown 更加灵活。
|
||||
|
||||
Marp 只自带两个基础主题,但你可以为幻灯片增加背景图片、调整图片大小以及增加数学表达式。不足之处,目前只支持 PDF 格式导出。老实说,我很好奇为何不一开始就提供 HTML 格式导出。
|
||||
|
||||
|
||||
![marp.png][14]
|
||||
|
||||
使用 Marp 编辑简单的幻灯片
|
||||
|
||||
### Pandoc
|
||||
|
||||
你可能已经知道 [pandoc][15] 是一种支持多种<ruby>标记语言<rt>markup languages</rt></ruby>相互转换的神奇工具。但你可能不知道,pandoc 可以将 Markdown 格式文件转换为 [Slidy][16]、[Slideous][17]、[DZSlides][18] 和 [Reveal.js][20] 等演示框架支持的优雅 HTML 幻灯片。如果你使用 [LaTeX][21],可以使用 [Beamer 软件包][22]输出 PDF 格式的幻灯片。
|
||||
|
||||
你需要在幻灯片中[使用特定格式][23],但可以通过[变量][24]控制效果。你也可以更改幻灯片的外观与风格,增加幻灯片之间的暂停,添加演示者注记等。
|
||||
|
||||
当然,你需要在你的主机上安装你喜欢的演示框架,因为 Pandoc 只生成原始幻灯片文件。
|
||||
|
||||
|
||||
![pandoc.png][26]
|
||||
|
||||
查看使用 Pandoc 和 DZSlides 创建的幻灯片
|
||||
|
||||
### Hacker Slides
|
||||
|
||||
[Hacker Slides][27] 是一个 [Sandstorm][28] 和 [Sandstorm Oasis][29] 平台上的应用,基于 Markdown 和 [Reveal.js][20] 幻灯片框架。生成的幻灯片可以比较朴素,也可以很炫。
|
||||
|
||||
在浏览器的两栏界面中编写幻灯片,左栏输入 Markdown 文本,右栏渲染效果。当你制作完成后,可以在 Sandstorm 中演示,也可以生成分享链接让其它人演示。
|
||||
|
||||
你可能会说,你不使用 Sandstorm 或 Sandstorm Oasis 怎么办?不要担心,Hacker Slides 提供了可以在桌面或服务器上运行的[版本][30]。
|
||||
|
||||
|
||||
![hacker-slides.png][32]
|
||||
|
||||
在 Hacker Slides 中编辑幻灯片
|
||||
|
||||
### 两点特别补充
|
||||
|
||||
如果你使用 [Jupyter <ruby>笔记本<rt>Notebooks</rt></ruby>][33] (参考社区版主 Don Watkins 的[文章][34])发布数据或指令文本,你可以使用 [Jupyter2slides][35]。该工具基于 Reveal.js,可以将笔记本转换为一系列精美的 HTML 幻灯片。
|
||||
|
||||
如果你倾向于托管应用,试试 [GitPitch][36],支持 GitHub,GitLab 和 Bitbucket。只需在将幻灯片源文件推送到支持的代码仓库中,在 GitPitch 中指向该仓库,这样你就可以在 GitPitch 网站上看到你的幻灯片了。
|
||||
|
||||
你有最喜欢的基于 Markdown 的幻灯片生成器吗?留下评论分享吧。
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
|
||||
via: https://opensource.com/article/18/5/markdown-slide-generators
|
||||
|
||||
作者:[Scott Nesbitt][a]
|
||||
选题:[lujun9972](https://github.com/lujun9972)
|
||||
译者:[pinewall](https://github.com/pinewall)
|
||||
校对:[校对者ID](https://github.com/校对者ID)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译,[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
[a]:https://opensource.com/users/scottnesbitt
|
||||
[1]:https://plaintextproject.online/
|
||||
[2]:https://en.wikipedia.org/wiki/Markdown
|
||||
[3]:https://github.com/adamzap/landslide
|
||||
[4]:https://en.wikipedia.org/wiki/ReStructuredText
|
||||
[5]:https://en.wikipedia.org/wiki/Textile_(markup_language)
|
||||
[6]:https://github.com/skaegi/html5slides
|
||||
[7]:/file/397441
|
||||
[8]:https://opensource.com/sites/default/files/uploads/landslide.png (landslide.png)
|
||||
[9]:https://yhatt.github.io/marp/
|
||||
[10]:https://en.wikipedia.org/wiki/Electron_(software_framework)
|
||||
[11]:https://guides.github.com/features/mastering-markdown/
|
||||
[12]:https://raw.githubusercontent.com/yhatt/marp/master/example.md
|
||||
[13]:/file/397446
|
||||
[14]:https://opensource.com/sites/default/files/uploads/marp.png (marp.png)
|
||||
[15]:https://pandoc.org/
|
||||
[16]:https://www.w3.org/Talks/Tools/Slidy2/Overview.html#(1)
|
||||
[17]:http://goessner.net/articles/slideous/
|
||||
[18]:http://paulrouget.com/dzslides/
|
||||
[19]:https://meyerweb.com/eric/tools/s5/
|
||||
[20]:https://revealjs.com/#/
|
||||
[21]:https://www.latex-project.org/
|
||||
[22]:https://en.wikipedia.org/wiki/Beamer_(LaTeX)
|
||||
[23]:https://pandoc.org/MANUAL.html#producing-slide-shows-with-pandoc
|
||||
[24]:https://pandoc.org/MANUAL.html#variables-for-slides
|
||||
[25]:/file/397451
|
||||
[26]:https://opensource.com/sites/default/files/uploads/pandoc.png (pandoc.png)
|
||||
[27]:https://github.com/jacksingleton/hacker-slides
|
||||
[28]:https://sandstorm.io/
|
||||
[29]:https://oasis.sandstorm.io/
|
||||
[30]:https://github.com/msoedov/hacker-slides
|
||||
[31]:/file/397456
|
||||
[32]:https://opensource.com/sites/default/files/uploads/hacker-slides.png (hacker-slides.png)
|
||||
[33]:http://jupyter.org/
|
||||
[34]:https://opensource.com/article/18/3/getting-started-jupyter-notebooks
|
||||
[35]:https://github.com/datitran/jupyter2slides
|
||||
[36]:https://gitpitch.com/
|
Loading…
Reference in New Issue
Block a user