寫(xiě)作工具

I’ve been writing about data science on Medium for just over two years. Writing, in particular, technical writing can be time-consuming. Not only do you need to come up with an idea, write well, edit your articles for accuracy and flow, and proofread them. With technical articles you often also need to produce code to illustrate your explanations, ensure that it is accurate and transfer that code from the tool you used to write it, to your Medium post.

我已經(jīng)寫(xiě)了兩年多關(guān)于Medium的數(shù)據(jù)科學(xué)的文章。 寫(xiě)作，特別是技術(shù)寫(xiě)作，可能很耗時(shí)。 您不僅需要提出一個(gè)想法，寫(xiě)得好，編輯文章以確保準(zhǔn)確性和流程性，并進(jìn)行校對(duì)。 在撰寫(xiě)技術(shù)文章時(shí)，您通常還需要編寫(xiě)代碼來(lái)說(shuō)明您的解釋，確保代碼準(zhǔn)確無(wú)誤，然后將代碼從您用來(lái)編寫(xiě)代碼的工具轉(zhuǎn)移到Medium帖子中。

I try to publish once or twice a week. When I first started writing I found that the process could be very time consuming, and it was difficult to maintain this schedule around a full-time day job.

我嘗試每周發(fā)布一次或兩次。 當(dāng)我第一次開(kāi)始寫(xiě)作時(shí)，我發(fā)現(xiàn)該過(guò)程可能非常耗時(shí)，并且很難在一個(gè)全日制工作中維持這個(gè)時(shí)間表。

Over time I have found some tools that have hugely sped up the time it takes for me to create and publish an article. Particularly those containing coded examples. The following tools help me to achieve my goal of publishing one to two articles per week around my other life commitments.

隨著時(shí)間的流逝，我發(fā)現(xiàn)一些工具極大地縮短了我創(chuàng)建和發(fā)布文章所需的時(shí)間。 特別是那些包含編碼示例的代碼。 以下工具可幫助我實(shí)現(xiàn)每周?chē)@其他人生承諾發(fā)表一到兩篇文章的目標(biāo)。

1. Jupyter至中 (1. Jupyter to Medium)

This tool was only released in May this year by Ted Petrou but it is a game-changer if you write your code in Jupyter Notebooks. With this Python package, you can publish the entire content of your notebook as a blog post directly into your Medium account.

該工具僅在今年5月由Ted Petrou發(fā)布，但是如果您在Jupyter Notebooks中編寫(xiě)代碼，它將改變游戲規(guī)則。 使用此Python軟件包，您可以將筆記本的全部?jī)?nèi)容作為博客文章直接發(fā)布到您的Medium帳戶中。

To use this tool first you need to pip install it into your project environment.

要首先使用此工具，您需要將其安裝到項(xiàng)目環(huán)境中。

pip install jupyter_to_medium

You may need to also install this extension in the environment you are launching your notebook from.

您可能還需要在啟動(dòng)筆記本計(jì)算機(jī)的環(huán)境中安裝此擴(kuò)展程序。

jupyter bundlerextension enable --py jupyter_to_medium._bundler --sys-prefix

Once installed, when you open a Jupyter Notebook and navigate to File >> Deploy as, you will now find an option to deploy as a Medium post.

安裝完成后，當(dāng)您打開(kāi)Jupyter Notebook并導(dǎo)航至File >> Deploy as時(shí)，您現(xiàn)在將找到一個(gè)選項(xiàng)作為Medium post進(jìn)行部署。

When you select this option you will be presented with a form. At the top, it asks for an integration token. If you are a regular writer on Medium you may have access to this in the settings in your Medium account. If you don’t have a token in your settings you will need to contact Medium to request one via this email address yourfriends@medium.com.

選擇此選項(xiàng)時(shí)，將顯示一個(gè)表格。 在頂部，它要求一個(gè)集成令牌。 如果您是Medium的普通作家，則可以在Medium帳戶的設(shè)置中訪問(wèn)此內(nèi)容。 如果您的設(shè)置中沒(méi)有令牌，則需要聯(lián)系Medium，以通過(guò)此電子郵件地址yourfriends@medium.com請(qǐng)求一個(gè)。

From my experience, you will get a response quite quickly, typically within 1 to 2 days.

根據(jù)我的經(jīng)驗(yàn)，您通常會(huì)在1-2天內(nèi)很快收到答復(fù)。

You can either paste your integration token into this form each time or, to save having to repeatedly access it, you can save the token as a file and directory labelled in the following way.jupyter_to_medium/integration_token.

您可以每次將集成令牌粘貼到此表單中，或者，為了避免重復(fù)訪問(wèn)，可以將令牌另存為文件和目錄，并以.jupyter_to_medium/integration_token方式標(biāo)記。

Jupyter to Medium will publish your markdown as text, code as code blocks and images directly to medium as a draft. I have found that you generally only need to perform minimal edits to then get to a publishable blog post.

Jupyter to Medium會(huì)將您的降價(jià)發(fā)布為文本，將代碼發(fā)布為代碼塊，并將圖像直接發(fā)布為草稿。 我發(fā)現(xiàn)您通常只需要執(zhí)行最少的編輯即可訪問(wèn)可發(fā)布的博客文章。

2. Github要點(diǎn) (2. Github Gists)

Github has a tool known as Github Gists that allow you to easily embed code snippets directly into your blog posts. The advantage of using Gists rather than code blocks in your articles is that they preserve the format of the code better, they promote your Github account and it is easier for readers to access your code to try the examples out for themselves.

Github有一個(gè)稱為Github Gists的工具，可讓您輕松地將代碼段直接嵌入到博客文章中。 在您的文章中使用Gist而不是代碼塊的優(yōu)點(diǎn)是，它們可以更好地保留代碼格式，可以提升您的Github帳戶，并使讀者更輕松地訪問(wèn)您的代碼來(lái)親自嘗試示例。

You will need a Github account to create a Gist. Once you have one simply navigate to the Gists page at gist.github.com. Creating a Gist is very simple, just give it a name, paste in your code and hit publish. Once published you will see this page. To embed the Gist in your Medium post simply code the URL under ‘Embed’ and paste into your article.

您將需要一個(gè)Github帳戶來(lái)創(chuàng)建一個(gè)Gist。 找到一個(gè)后，只需導(dǎo)航至gist.github.com的Gist頁(yè)面即可 。 創(chuàng)建一個(gè)Gist非常簡(jiǎn)單，只需給它命名，粘貼代碼并點(diǎn)擊publish。 發(fā)布后，您將看到此頁(yè)面。 要將Gist嵌入到您的Medium帖子中，只需將URL編碼在“ Embed”下，然后粘貼到您的文章中即可。

The code displays in your Medium post as shown below.

該代碼顯示在您的中號(hào)帖子中，如下所示。

import plotly.express as pxfig = px.scatter(data, x='RM', y='TARGET', title='Age vs Target') fig.show()

3. Jovian.ml (3. Jovian.ml)

Jovian.ml is a tool for hosting Jupyter Notebooks online which is very useful for sharing analyses externally from your local environment. Jovian recently released a feature which makes it possible to embed entire notebooks, snippets of code, cell outputs and markdown directly into your Medium posts.

Jovian.ml是用于在線托管Jupyter Notebook的工具，對(duì)于從本地環(huán)境外部共享分析非常有用。 Jovian最近發(fā)布了一項(xiàng)功能，可以將整個(gè)筆記本，代碼段，單元格輸出和減價(jià)直接嵌入到您的Medium帖子中。

To get started with Jovian you need to create an account on jovian.ml. The free tier gives you unlimited public projects which is ideal if you are using it to share via a Medium blog. You then need to pip install into your local environment.

要開(kāi)始使用Jovian，您需要在jovian.ml上創(chuàng)建一個(gè)帳戶。 免費(fèi)套餐為您提供無(wú)限的公共項(xiàng)目，如果您正在使用它通過(guò)中型博客進(jìn)行共享，那么這是理想的選擇。 然后，您需要將pip安裝到本地環(huán)境中。

pip install jovian

To upload a local Jupyter Notebook to your online Jovian account simply run the following in your notebook.

要將本地Jupyter筆記本上載到您的在線Jovian帳戶，只需在筆記本中運(yùn)行以下命令即可。

import jovian
jovian.commit()

This will prompt you for an API key which you will find in your account.

這將提示您輸入在帳戶中找到的API密鑰。

To embed specific snippets of code in a cell. Navigate to the notebook you have uploaded to your online account and the cell containing the code you want to share. Click on Embed Cell.

將特定的代碼片段嵌入單元格中。 導(dǎo)航到您已上傳到在線帳戶的筆記本以及包含要共享代碼的單元格。 單擊“ 嵌入單元” 。

This will give you a link you can paste into your Medium post.

這將為您提供一個(gè)鏈接，您可以將其粘貼到“ Medium”帖子中。

This then displays as shown below.

然后顯示如下。

演示地址

4.語(yǔ)法上 (4. Grammarly)

Grammarly is quite a well-known app that checks your content for typos, grammatical errors and even the sentiment of your text. Although an obvious tool for writing it took me a while to start using it, and it made such a difference to the editing time for my articles so I thought it was worth sharing here.

Grammarly是一個(gè)非常著名的應(yīng)用程序，它可以檢查您的內(nèi)容是否有錯(cuò)別字，語(yǔ)法錯(cuò)誤，甚至您的文字情感。 盡管一個(gè)明顯的編寫(xiě)工具花了我一段時(shí)間才開(kāi)始使用它，并且它對(duì)文章的編輯時(shí)間產(chǎn)生了很大的影響，所以我認(rèn)為值得在這里分享。

Grammarly can be installed as a browser extension, locally as a desktop app or as a mobile app. To maximise the use of my time I write in many different environments so it is useful to have Grammarly installed locally if I am writing offline, in my browser for when I am directly writing on Medium and on my mobile if I am writing on the go.

語(yǔ)法可以作為瀏覽器擴(kuò)展安裝，可以在本地作為桌面應(yīng)用程序或移動(dòng)應(yīng)用程序安裝。 為了最大限度地利用我的時(shí)間，我在許多不同的環(huán)境中寫(xiě)作，因此，如果我離線寫(xiě)作，在瀏覽器中將Grammarly安裝在本地是很有用的，這樣當(dāng)我直接在Medium上書(shū)寫(xiě)時(shí)和在移動(dòng)設(shè)備上書(shū)寫(xiě)(如果我在旅??途中書(shū)寫(xiě)) 。

If you are interested in posts about data science writing on Medium you might find these earlier articles I wrote on the subject useful too.

如果您對(duì)在Medium上有關(guān)數(shù)據(jù)科學(xué)寫(xiě)作的帖子感興趣，那么您可能會(huì)發(fā)現(xiàn)我在該主題上撰寫(xiě)的這些較早的文章也很有用。

Thanks for reading!

謝謝閱讀！

I send out a monthly newsletter if you would like to join please sign up via this link. Looking forward to being part of your learning journey!

如果您想加入，我會(huì)每月發(fā)送一次通訊，請(qǐng)通過(guò)此鏈接注冊(cè)。 期待成為您學(xué)習(xí)之旅的一部分！

翻譯自: https://towardsdatascience.com/4-tools-to-speed-up-your-data-science-writing-11d3823cd01b

寫(xiě)作工具

總結(jié)

以上是生活随笔為你收集整理的写作工具_4种加快数据科学写作速度的工具的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。