通訊指南#
部落格#
我們的部落格釋出在 https://blog.jupyter.org。我們歡迎 Jupyter 部落格的文章構思或客座文章。如果您對未來的文章有建議,請隨時與我們分享您的想法。我們很樂意與您討論這個想法。
您喜歡寫作嗎?請聯絡我們,成為客座博主。我們可以指導您完成文章創作過程。
技術概述#
Jupyter 的部落格使用 Ghost 部落格平臺,因為它具有貢獻者靈活性和易用性。Jupyter 的部落格部署在 https://blog.jupyter.org。
從部落格構思到釋出文章的基本工作流程#
從部落格構思到釋出文章的工作流程包括幾個主要步驟,包括
獲得寫作靈感
在 Jupyter 郵件列表中給我們傳送訊息,並請求獲得我們部落格的作者賬戶
建立草稿
草稿審查
編輯稽核透過
釋出文章
我們將涵蓋這些內容以及如何在文章釋出後進行更新。
建立草稿#
標題和元資料#
始終檢查元資料欄位,確保部落格文章有標題和規範 URL。可以在規範 URL 中加入日期,特別是對於像 jupyter-day 這樣可能發生多次的事件。事件日期可能與部落格文章的日期不同。
文章釋出後,絕不能更改文章的標題或 URL。這些更改會破壞已經引用現有已釋出 URL 的推文和 RSS 訂閱的連結。請記住,釋出時某些平臺會立即快取 URL;因此,更改標題會導致使用者訪問 404 頁面。
標題和元資料可以在部落格實際內容撰寫完成後進行修改,但釋出後不應更改。作為客座作者,您無需擔心元資料,編輯或管理員會處理。
使用圖片#
儘量不要連結到外部圖片。如果您想在文章中插入圖片,請在編輯檢視中插入 ![]()
,然後將圖片從桌面拖放到新建立的預覽欄位中。外部圖片可能會更改,如果它們被刪除,可能會導致部落格文章損壞。如果您拖放圖片,則不會發生這種情況。此外,這些圖片將從與部落格相同的 CDN(內容分發網路)提供,這將確保為我們的讀者提供最佳的整體體驗。
您在部落格文章頂部看到的特色圖片是在元資料欄位中設定的,而不是使用 ![]()。特色圖片與內聯圖片在許多新聞閱讀器(尤其是在移動裝置上)中的處理方式不同,它允許慢速連線的使用者更早地閱讀部落格內容,這比等待特色圖片渲染對使用者來說是更好的體驗。
連結#
儘可能不要使用縮短的連結。縮短連結的多次重定向會降低移動瀏覽體驗。如果您需要頁面瀏覽量的分析,此資訊由 Google Analytics 跟蹤。
草稿審查#
請求審查#
一旦您認為您已完成,請讓其他人重新閱讀您的文章,並檢查您在釋出前可能忘記的各種引數。您不是孤軍奮戰,這是團隊合作,我們在這裡幫助您。如果我們匆忙行事,您可能會花更多時間糾正錯誤,而不是一開始就做好事情。
編輯稽核透過#
釋出文章#
通常由編輯或管理員負責釋出文章。編輯/管理員的任務是檢查所有元資料是否設定正確,沒有使用外部圖片,以及之前描述的所有其他質量檢查。
然後就是讓文章對所有人可見的問題了。
修改現有文章#
文章更新#
部落格訂閱者可能會在每次更新時收到通知。因此,請謹慎使用更新和修復。等待幾個小時修復一個錯字是可以接受的。
如果需要進行重大更新,例如更改地點、時間等,請在部落格文章頂部(或底部,取決於重要性)插入一個 [更新] 部分,並附上更新的日期/時間。如果部落格正文中的資訊有誤,請儘量不要替換它,而只使用刪除線將其標記為過時。這將有助於讀者在處理多個來源提供不同資訊時確定哪些資訊是正確的。
網站#
文件正在完善中。