方格精選

技術文章的寫作顧慮

更新於 發佈於 閱讀時間約 3 分鐘
早些年,當我有個點子,開始想要寫技術文章的時候,常有一些顧慮,致使我打消寫作的念頭。後來,我把這些想法整理出來,寫成文字,那層憂慮和壓力似乎就削減了些。也許這篇文章談到的問題不只限於技術寫作,而是所有嘗試寫作的人都可能碰到的問題。

在自家部落格寫初稿

有時覺得,有些主題,網路上已經有不少人寫了,我還要再多添一筆嗎?況且,又不見得寫得比別人豐富、深入、精彩。這想法會阻止我動筆。然而,從整理筆記、檢驗自己學習成果的角度來看,那種想法又顯得太消極了。
猶豫不決的話,不妨先在自己的部落格寫點初稿。畢竟是自家後院,只要不妨礙觀瞻,沒違反善良風俗,便無需顧慮太多。再者,寫完初稿之後,還可以反覆琢磨潤飾,改到自己滿意為止。

抄襲的顧慮

對於軟體程式之類的技術,如果不是第一線的研發人員或原作者,寫出來的文章大凡比較接近推廣、傳播,亦即經由第一手資料的咀嚼之後,再以自己的話來闡述,成就第二手、甚至第三、四手的參考資料。這樣的文章與所謂的第一手資料相比,自然缺了點創新,甚至有些地方會很相似;若擔心被旁人指謫抄襲或缺乏原創性,也是動筆的阻礙。
若撰文動機並非抄襲,並且在引用他人文句時適當加註、老實列出參考資料來源,應可避免剽竊抄襲之嫌。當然,如果一篇文章裡面有八九成都是引用他人的文章內容,誠實固然做到了,卻沒有太大的參考價值。
朱光潛在《談文學》中說:
「世間可想到、可說出的話在大體上都已經前人想過說過;然而後來人卻不能因此就不去想不去說,因為每個人有他的特殊的生活情境與經驗,所想所說的雖大體上仍是那樣的話,而想與說的方式卻各不相同。變遷了形式,就變遷了內容。所以他所想所說儘管在表面上仍是老生常談,而實際上卻可以是一種新鮮的作品,如果選擇與安排給了他一個新的形式、新的生命。」
這不僅適用於文學寫作,技術文章的寫作亦可如此看待。
所以重點在於,我們所寫出來的東西,是否真的是我們心裡所想的、所理解的、所感受的。如果是,那麼除了對自己有益之外,對此議題有興趣的人看到了,或許我們的文章表現方式正好與他們大腦的接收頻率相符,也就產生了額外的效益:讓更多人了解某項議題。這也是好事一樁。

從翻譯到寫筆記,再到創作

假設我正在看一篇英文的技術文章,發現裡面有值得學習或記下的東西,我可能會先在心裡做部分翻譯,轉成我自己可以理解的語言。當值得記下的東西多到一個程度,覺得有點份量了,我會打開電腦或筆記本,把它們寫下來(當然也可能因為一時懶惰就隨時間淡忘了,這就很可惜)。
起初雖然像文抄公,但一開始動筆或敲鍵盤,往往會促使自己把原先想的東西再整理一遍,此時可能會發現一些遺漏的細節,或者新的想法。這些新發現,其中可能有些值得繼續延伸探索,或者深入,或者旁通,繼而發展成自己在學習過程的一條脈絡。循此脈絡所寫出來的東西,便增添了創作的成分,有了自己的生命;裡面或有前輩的研究成果,但也包含自己的心得與發現。
有人說,翻譯也是一種創作。從剛才描述的這個學習過程來看,翻譯也可以是通向創作的一個門徑吧。我翻譯的書籍雖然不多,但回頭來看,那些逐字逐句把英文翻譯成中文的日子,的確為我日後的技術寫作之路埋下一顆種子。
Keep writing!
為什麼會看到廣告
avatar-img
14會員
23內容數
這裡有我寫作與自行(獨立)出版電子書的實戰心得與相關知識,包括:寫作與出版工具的使用、各出版平台的比較、電子書上架的逐步教學、行銷技巧、以及持續進行的出版實驗心得與發現。 如果您也想了解如何自行出版電子書,歡迎一起來學習、相互切磋。
留言
avatar-img
留言分享你的想法!

































































閱讀|寫作|出版 的其他內容
我無意間從 Google 搜尋結果中發現自己的電子書被放在某個海盜網站上公開讓人下載,才想到自己已經很久沒有上網調查盜版的情形了。經我舉報,該網站已經被整個個撤銷(而不單單是下架我的作品頁面),文中也會簡述舉報過程。
「智者的常軌,乃雄心之明證。」W. H. Auden 所說的這句話,我認為幾乎可概括全書宏旨。其餘篇章有許多重複,可以跳著讀、選自己感興趣的作家/藝術家來讀。
我無意間從 Google 搜尋結果中發現自己的電子書被放在某個海盜網站上公開讓人下載,才想到自己已經很久沒有上網調查盜版的情形了。經我舉報,該網站已經被整個個撤銷(而不單單是下架我的作品頁面),文中也會簡述舉報過程。
「智者的常軌,乃雄心之明證。」W. H. Auden 所說的這句話,我認為幾乎可概括全書宏旨。其餘篇章有許多重複,可以跳著讀、選自己感興趣的作家/藝術家來讀。
本篇參與的主題活動
在眾多寫作指南中,三浦紫苑的作品別具一格,強調寫作的核心在於品味。透過比喻料理的方式,她為新手作家提供了多方面的寫作建議,不僅涵蓋靈感與文風,還有結構與敘事的技巧。這篇文章探討瞭如何透過生活經驗增強個人品味,尋找寫作中的獨特風格,並鼓勵作家將內心的思考融入創作,創造出更具深度的作品。
今晚,就來和訂閱制讀者分享新書楔子的三分之一。原本想要把楔子整個貼上來,卻發現楔子就有六千多字,所以決定還是放三分之一就好。其實現在看這些,都覺得和自己判若兩人,有的地方連自己都不敢看下去——原來高瑞希,過去活得這麼不開心。 前天訂閱制讀者表達課第二期開班,因為感冒無法帶課,所以事先錄製了講解
歡迎來到方格新手村第一站!參加方格主題活動,發表任何一篇貼文、文章加上指定標籤, 就有機會得到免費禮券,或是讓 vocus 把你的創作推薦給全站會員! 現在就完成新手村任務,讓更多人認識你!
在眾多寫作指南中,三浦紫苑的作品別具一格,強調寫作的核心在於品味。透過比喻料理的方式,她為新手作家提供了多方面的寫作建議,不僅涵蓋靈感與文風,還有結構與敘事的技巧。這篇文章探討瞭如何透過生活經驗增強個人品味,尋找寫作中的獨特風格,並鼓勵作家將內心的思考融入創作,創造出更具深度的作品。
今晚,就來和訂閱制讀者分享新書楔子的三分之一。原本想要把楔子整個貼上來,卻發現楔子就有六千多字,所以決定還是放三分之一就好。其實現在看這些,都覺得和自己判若兩人,有的地方連自己都不敢看下去——原來高瑞希,過去活得這麼不開心。 前天訂閱制讀者表達課第二期開班,因為感冒無法帶課,所以事先錄製了講解
歡迎來到方格新手村第一站!參加方格主題活動,發表任何一篇貼文、文章加上指定標籤, 就有機會得到免費禮券,或是讓 vocus 把你的創作推薦給全站會員! 現在就完成新手村任務,讓更多人認識你!
你可能也想看
Google News 追蹤
Thumbnail
規劃一份有效的數位行銷計畫,能幫助品牌在競爭激烈的市場中脫穎而出。本文將深入探討如何分析目標受眾、選擇正確的行銷渠道,以及建立具體可行的年度策略。我們將提供實用範例與精準指引,協助你從內容創建到廣告投放,全面提升品牌知名度與銷售表現。立即閱讀,找到專屬於你的行銷突破口!
Thumbnail
|徐國峰 策畫・選書.導讀 臉譜出版 科學化運動訓練書系KFCS 作品| 「《自行車功率訓練全書》是功率訓練的終極指南。透過深入淺出的專業知識和豐富清晰的視覺圖表,本書將幫助你成功將功率數據轉換為你的速度,幫助你達到最佳的訓練效率與賽事表現。
Thumbnail
這篇文章探討雙閱讀素養在教學中的應用,特別是如何將文本中客觀事實和個人觀點進行有效區分。透過對「田園之秋選」和「鳥」的分析,作者揭示了大自然乃至人類情感的深層意義。文章重點在於幫助學生理解文本背後的核心概念和作者的情感表達,從而提升閱讀素養。
Thumbnail
我當了記者、新聞主管、廣播主持人,從事新聞工作十多年,文字、口說、表達能力都有一定的水準,雖然常常會興起寫部落格的想法,但都是註冊後 貼個幾篇文章,然後就不了了之 如果連我職涯一開始當記者,後來當過上市公司的公關、行銷、企業高階主管,都不知道該分享什麼給別人,我相信有更多人也會覺得「我要寫什麼?」
Thumbnail
2024 年巴黎奧運的會徽簡單俐落,結合三個元素:金牌、聖火、瑪麗安娜女神,象徵法國風情與精神,向女性運動員與歷史致敬,是奧運 Logo 史上首次以臉部為形象。亦跳出傳統觀念,設計元素不僅應用於活動標誌,更透過多樣的顏色、形象與特色,顯揚了奧運全球化與多元文化特質。
Thumbnail
這篇文章將提供一個完整的Kubernetes安裝指南,包括控制平面節點和工作節點的安裝過程。文章中還會提及一些參考資料和解決常見錯誤的方法。
「構思,動詞,指運用心思,常指寫文章或創作藝術前所用的思考。」 「構思其實是一種想像力,在事情尚未發生之前,先想像出它完成後的模樣。 覺得這模樣還不錯,修修補補,加以完善,然後動手實際操作。」 「有兩種靈感值得珍藏。一種事你明顯感覺到可以跟著他順流而下,把所有關節都打通。 另
據我的觀察,一個有強烈企圖心又有組稿和撰稿能力的編輯,在離開出版社以後,他們多半會嚐試編纂或編譯工作,以此克服眼高手低的困境。與此同時,如果真能實現意到筆到如意所至的話,那麼這位編書高手其實力已不遜於普通的作家了。   毋需贅言,這種說法只是普通常識,不過,我知道好鬥和投機者仍要提出反駁的。文友
Thumbnail
一直以來都想寫些什麼,但卻遲遲無法踏出第一步,又放不下對文字的執念,不管是手寫或是在鍵盤上敲敲打打,就是想在這個影像當道的年代,留下一些屬於自己的堅持。看了很多文字創作者的建議和寫作指南,還是沒有頭緒,於是一個轉念,決定先把這個躊躇不前的階段記錄下來,至於以後,或是有沒有以後,就再說了。
Thumbnail
我很喜歡寫作,尤其現代詩的創作,從年輕一直持續到中年四十時光,對我來講,創作現代詩,並不是很容易的一件事,這部份的想法偏向創作理論的想法° 我是在新竹讀國中,接觸新竹青年月刊,裡面有不少詩作供人欣賞閱讀° 印象是一篇行道樹的詩作,題材來自張曉風的行道樹散文,這不算
Thumbnail
規劃一份有效的數位行銷計畫,能幫助品牌在競爭激烈的市場中脫穎而出。本文將深入探討如何分析目標受眾、選擇正確的行銷渠道,以及建立具體可行的年度策略。我們將提供實用範例與精準指引,協助你從內容創建到廣告投放,全面提升品牌知名度與銷售表現。立即閱讀,找到專屬於你的行銷突破口!
Thumbnail
|徐國峰 策畫・選書.導讀 臉譜出版 科學化運動訓練書系KFCS 作品| 「《自行車功率訓練全書》是功率訓練的終極指南。透過深入淺出的專業知識和豐富清晰的視覺圖表,本書將幫助你成功將功率數據轉換為你的速度,幫助你達到最佳的訓練效率與賽事表現。
Thumbnail
這篇文章探討雙閱讀素養在教學中的應用,特別是如何將文本中客觀事實和個人觀點進行有效區分。透過對「田園之秋選」和「鳥」的分析,作者揭示了大自然乃至人類情感的深層意義。文章重點在於幫助學生理解文本背後的核心概念和作者的情感表達,從而提升閱讀素養。
Thumbnail
我當了記者、新聞主管、廣播主持人,從事新聞工作十多年,文字、口說、表達能力都有一定的水準,雖然常常會興起寫部落格的想法,但都是註冊後 貼個幾篇文章,然後就不了了之 如果連我職涯一開始當記者,後來當過上市公司的公關、行銷、企業高階主管,都不知道該分享什麼給別人,我相信有更多人也會覺得「我要寫什麼?」
Thumbnail
2024 年巴黎奧運的會徽簡單俐落,結合三個元素:金牌、聖火、瑪麗安娜女神,象徵法國風情與精神,向女性運動員與歷史致敬,是奧運 Logo 史上首次以臉部為形象。亦跳出傳統觀念,設計元素不僅應用於活動標誌,更透過多樣的顏色、形象與特色,顯揚了奧運全球化與多元文化特質。
Thumbnail
這篇文章將提供一個完整的Kubernetes安裝指南,包括控制平面節點和工作節點的安裝過程。文章中還會提及一些參考資料和解決常見錯誤的方法。
「構思,動詞,指運用心思,常指寫文章或創作藝術前所用的思考。」 「構思其實是一種想像力,在事情尚未發生之前,先想像出它完成後的模樣。 覺得這模樣還不錯,修修補補,加以完善,然後動手實際操作。」 「有兩種靈感值得珍藏。一種事你明顯感覺到可以跟著他順流而下,把所有關節都打通。 另
據我的觀察,一個有強烈企圖心又有組稿和撰稿能力的編輯,在離開出版社以後,他們多半會嚐試編纂或編譯工作,以此克服眼高手低的困境。與此同時,如果真能實現意到筆到如意所至的話,那麼這位編書高手其實力已不遜於普通的作家了。   毋需贅言,這種說法只是普通常識,不過,我知道好鬥和投機者仍要提出反駁的。文友
Thumbnail
一直以來都想寫些什麼,但卻遲遲無法踏出第一步,又放不下對文字的執念,不管是手寫或是在鍵盤上敲敲打打,就是想在這個影像當道的年代,留下一些屬於自己的堅持。看了很多文字創作者的建議和寫作指南,還是沒有頭緒,於是一個轉念,決定先把這個躊躇不前的階段記錄下來,至於以後,或是有沒有以後,就再說了。
Thumbnail
我很喜歡寫作,尤其現代詩的創作,從年輕一直持續到中年四十時光,對我來講,創作現代詩,並不是很容易的一件事,這部份的想法偏向創作理論的想法° 我是在新竹讀國中,接觸新竹青年月刊,裡面有不少詩作供人欣賞閱讀° 印象是一篇行道樹的詩作,題材來自張曉風的行道樹散文,這不算