本文將從準(zhǔn)備工作、文章結(jié)構(gòu)、注意事項(xiàng)等方面展開,希望對樂于分享的同學(xué)有一定啟發(fā)。
準(zhǔn)備工作
動手寫文章前,須依次明確兩點(diǎn):目標(biāo)受眾;寫作思路。
明確目標(biāo)受眾
誰會看我們的文章?
誰會對我們的文章感興趣?
這是撰寫文章的首要問題。
動手前,一定要先想好你的目標(biāo)受眾,即文章面向哪些讀者。要充分考慮讀者的背景。面向的讀者不同,語言風(fēng)格、展現(xiàn)形式等也須有所不同。以技術(shù)科普文章為例,你需要提供充足的背景知識,通過場景化、故事性的方式切入主題,并提供一系列簡單、可復(fù)現(xiàn)的示例。
梳理寫作思路
明確受眾之后,可以用某種結(jié)構(gòu)化的形式梳理寫作思路,如帶有層級的列表、思維導(dǎo)圖等。如下圖所示,正式寫作本文前,我使用 markdown 梳理了本文寫作的大致思路。
再經(jīng)幾番調(diào)整,文章的基本框架便有了,可以開始撰寫初稿。當(dāng)然,這個基本框架也會隨著寫作的推進(jìn)不斷動態(tài)調(diào)整。
曲線辦法
另外,這里提供一個曲線解決問題的懶人思路。該思路來源于各類技術(shù)大會實(shí)錄。
寫文章前,你也可以先做一份 ppt(結(jié)構(gòu)清晰、內(nèi)容精美者為佳),并將 ppt 轉(zhuǎn)換為圖片逐次放入文稿中。
寫作時,只當(dāng)自己在面對觀眾做現(xiàn)場 presentation,將要說的話適當(dāng)潤色,插入到每張 ppt 前后。注意配以適當(dāng)?shù)霓D(zhuǎn)折語句。
這樣的好處有三:圖文并茂,適合閱讀;信息密度較純文字高;傳達(dá)文字不足以完成的信息。
文章結(jié)構(gòu)
優(yōu)秀文章套路基本相似,問題文章則各有各的缺點(diǎn)。這里我用“起承轉(zhuǎn)合”四字來概括基本套路。
“起”
忘了是誰說的,好的開頭是成功的一半。
一般來說,在文章開頭,你需要交代寫作緣起,如業(yè)務(wù)遭遇痛點(diǎn)、線上神秘 bug 等。
而后,簡要介紹文章將從哪些方面展開、達(dá)到什么目的,而讀者能從中獲得何種收獲。
“承”
承接開頭,開始按事先整理的大綱,切入正題。可以開始詳細(xì)介紹相關(guān)場景、探索解決方案的歷程。
需要注意的是,始終不能忘記目標(biāo)受眾。根據(jù)目標(biāo)受眾特點(diǎn),注意在必要的地方,提供必要的背景知識,如某項(xiàng)技術(shù)的發(fā)展歷史及相關(guān)術(shù)語介紹。
“轉(zhuǎn)”
經(jīng)過前面的充分鋪墊,話題轉(zhuǎn)入突破階段??梢栽敿?xì)介紹你所尋找到的突破方案及其效果。如有多種方案,建議同時列出,并加以對比。
“合”
回顧全文,適當(dāng)總結(jié):
- 文章解決了什么問題?
- 還可以進(jìn)行哪些方向的探索?
- 有何不足之處?
- 展望未來
注意事項(xiàng)
在寫作過程中,有一些細(xì)節(jié)需要注意。
切忌以下問題 ——
- 羅列大量術(shù)語:全無背景介紹,直接開始羅列一堆概念
- 粘貼長篇代碼:大篇幅引用代碼,影響閱讀體驗(yàn)
- 風(fēng)格變化無常:時而嚴(yán)肅、學(xué)術(shù)風(fēng),時而賣萌、抖機(jī)靈
- 內(nèi)容貪圖簡便:使用代碼塊、圖片或 blockquote 完全取代正文
有以上問題且難以克服者,建議使用前述“曲線辦法”,可能一定效果。
總結(jié)
以上談了一些技術(shù)文章寫作的套路,但更重要的還是日常積累。
當(dāng)然,日常學(xué)習(xí)時也要有所甄別,擁抱精品,遠(yuǎn)離次品。
相關(guān)閱讀:
作者:文藺 來源:奇舞團(tuán)(75.team)