Note的內容是要讓搜尋引擎看得懂,不是你

Note的內容是要讓搜尋引擎看得懂,不是你

更新於 發佈於 閱讀時間約 4 分鐘

這內容有問題嗎?

這也是一個蠻常見的Redmine寫作問題:

你能”感覺”的出來,這有什麼問題嗎?

上面寫著:「根據文章…」,然後是一張貼圖(對,Java那個是貼圖)。你能感覺得出來,這有什麼問題嗎?我想你伸長脖子,拿下眼鏡(像我有老花,太近的東西我就看不清了),邊讀邊念,應該都不會覺得內容有什麼問題吧?

這不是「大家來找碴」遊戲,只是我個人比較機車吧…看到這種內容,當下腦中的警報就嗡嗡作響。為了怕我的金魚腦在3分鐘後,就會把這麼重要的事情給忘掉,我只好當場就請作者來詢問幾個問題:

「xxx,你只寫了根據”文章”,那方便告訴我是根據哪裡的文章嗎」?
「你在這裡貼了裡面都是字的圖,可因為它是圖,屆時我搜尋不到怎麼辦呢?」

所以,真正的問題不是內容你看不看得懂,而是搜尋引擎看不看得懂。

連結怎麼貼最好?

第一個問題是不曉得是根據哪一篇文章,不就是貼連結而已嗎?若我今天是貼上像「https://www.sqlsec.com/2018/05/termux.html#toc-heading-31」這樣的內容,對我們地球人來說雖然是可以連回到文章出處,但問題就在於連結的內容無法被Redmine給搜尋出來。

今天這個issue是在講用戶如何跟Termux通訊,而文章在講Termux如何和Linux及JavaVM三方通訊。若是3年後的某一天,你依稀只記得「Termux好像跟Linux或Java有關係」?而在今天你貼上的只是這個連結,3年後在Redmine中搜尋Linux或是Java,你其實完全搜不到這篇文章的。
(3年太久了,基本上3週後你就什麼都不記得了…😅)

比較好的超連結貼法是:將文章的標題「Termux如何和Linux及Java VM三方通訊」給貼上去,然後將這段文字加上超連結。如此一來,Redmine既可搜尋到Termux/Linux/JavaVM這些關鍵字,用戶也可以透過這個連結找到文章出處去深入瞭解。

圖是用來解決人的問題

第二個問題是那個貼圖,這是一個比較極端的例子,因為裡面都是字!
(例子極端,但出現的頻率倒是蠻高的…😑)

和第一個問題有著類似的問題,用戶現在用眼睛看,當然知道有什麼資訊在裡面。可3年之後若你想找「ecj」這個關鍵字,Redmine是搜不到的關鍵字的。自然用戶就不會知道,其實他自己找到過的答案就在這裡。

好,我聽到有人會說,有的網頁上真的就是把軟體的截圖放上來啊,source就不是字,我要怎麼把它變成字呢?總不會叫我抄打一份吧?

這裡就比較tricky了。比較有效率的方法是,透過線上OCR的服務來解決問題,像是誠華OCROnlineOCREasyScreenOCR。但我自己最常用的反而是Google Keep

除非原圖太糊,不然我是都蠻滿意的。把這張圖裡的字給辨識出來後,再自己修整一下,就可以貼到裡面來。當然也可以結合第一個問題的解法,找個關鍵字貼上連結,就可讓用戶搜得到關鍵字,也能連到原文出處去看圖,一舉兩得。

avatar-img
SharpWriter(周乃宏)的沙龍
34會員
69內容數
Google實驗室Area120釋出了一個「製作遊戲」的遊戲叫「Game Builder」。 主要的用戶是遊戲編導,方便他們以拖拉卡片的型式來驗證遊戲性好不好。 因此這個專題就是「Game Builder」的"真心話(好用難用都會說)"和"大冒險(真的來挑戰看看能做什麼遊戲)"囉!
留言
avatar-img
留言分享你的想法!
這一天,終於定案A的處理,要請他離開公司。本以為這種事會由部長出面統一來談,沒想到會是我來談。 「這是在說我工作的不夠努力嗎?」 「我之前貢獻了那麼多心力,現在就這樣一刀切,這樣對嗎?」 「我能理解公司需要轉型,但都沒有給員工選擇,鈊象是這樣對待員工的嗎?」 把要請他準備離開公司的事說完後…
2020年9月3日這一天算是電玩界的一個大日子,因為這是瑪莉歐世界的35週年。任天堂(Nintendo)為了慶祝這個對它們實屬意義非凡的日子,推出了不少懷舊產品。有一個意想不到的產品也隨之發表:「Mario Kart Live Home Circuit」…
去年的Oculus Connect大會上,Facebook發表了虛擬社交平台「Horizon」。這是一個讓玩家帶上Oculus裝置,沈浸其中的虛擬世界。在裡面有許多小遊戲可以玩…
技術上來說,這篇算是在炒冷飯。XD 由於每年一次的運動月,已經變成部門的傳統了,但這次和去年又有很大的不同 – 有一整批新的團隊加入了我們。因為這次帶領的團隊又整個都不一樣了,印象中…這批團隊應該都沒看過我這些激勵文吧?所以我決定把去年用來激勵大家運動的冷飯拿來炒一下。
這篇是意外翻到的,本來只貼在Medium,就再貼過來給大家分享。基本上這算是《精準學習》的讀後心得,不過今天再重看一次,還是覺得蠻有感的。
由於最近稍微休息了一陣子(其實就是「懶癌」發作的很嚴重…),所以決定再把之前看的《罗振宇 知识就是力量:怎样逼自己成为一个上进的人》拿來激勵自己一下…
這一天,終於定案A的處理,要請他離開公司。本以為這種事會由部長出面統一來談,沒想到會是我來談。 「這是在說我工作的不夠努力嗎?」 「我之前貢獻了那麼多心力,現在就這樣一刀切,這樣對嗎?」 「我能理解公司需要轉型,但都沒有給員工選擇,鈊象是這樣對待員工的嗎?」 把要請他準備離開公司的事說完後…
2020年9月3日這一天算是電玩界的一個大日子,因為這是瑪莉歐世界的35週年。任天堂(Nintendo)為了慶祝這個對它們實屬意義非凡的日子,推出了不少懷舊產品。有一個意想不到的產品也隨之發表:「Mario Kart Live Home Circuit」…
去年的Oculus Connect大會上,Facebook發表了虛擬社交平台「Horizon」。這是一個讓玩家帶上Oculus裝置,沈浸其中的虛擬世界。在裡面有許多小遊戲可以玩…
技術上來說,這篇算是在炒冷飯。XD 由於每年一次的運動月,已經變成部門的傳統了,但這次和去年又有很大的不同 – 有一整批新的團隊加入了我們。因為這次帶領的團隊又整個都不一樣了,印象中…這批團隊應該都沒看過我這些激勵文吧?所以我決定把去年用來激勵大家運動的冷飯拿來炒一下。
這篇是意外翻到的,本來只貼在Medium,就再貼過來給大家分享。基本上這算是《精準學習》的讀後心得,不過今天再重看一次,還是覺得蠻有感的。
由於最近稍微休息了一陣子(其實就是「懶癌」發作的很嚴重…),所以決定再把之前看的《罗振宇 知识就是力量:怎样逼自己成为一个上进的人》拿來激勵自己一下…