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
留言分享你的想法!
avatar-img
SharpWriter(周乃宏)的沙龍
34會員
69內容數
Google實驗室Area120釋出了一個「製作遊戲」的遊戲叫「Game Builder」。 主要的用戶是遊戲編導,方便他們以拖拉卡片的型式來驗證遊戲性好不好。 因此這個專題就是「Game Builder」的"真心話(好用難用都會說)"和"大冒險(真的來挑戰看看能做什麼遊戲)"囉!
2024/11/21
引文中最後的那句「大疆成立至今將近20年,在無人機應用上仍舊保有競爭力」,如果認真想想就會意識到那有多恐怖. 那20年專注在無人機的功力,已經不只是創辦人眼光的問題了...
Thumbnail
2024/11/21
引文中最後的那句「大疆成立至今將近20年,在無人機應用上仍舊保有競爭力」,如果認真想想就會意識到那有多恐怖. 那20年專注在無人機的功力,已經不只是創辦人眼光的問題了...
Thumbnail
2024/11/01
品質才是決定工作生產力的重點。
2024/11/01
品質才是決定工作生產力的重點。
2024/10/27
「不批評,不指責,不抱怨」三大核心精神,真的是「不可能」的嗎?
Thumbnail
2024/10/27
「不批評,不指責,不抱怨」三大核心精神,真的是「不可能」的嗎?
Thumbnail
看更多
你可能也想看
Thumbnail
「欸!這是在哪裡買的?求連結 🥺」 誰叫你太有品味,一發就讓大家跟著剁手手? 讓你回購再回購的生活好物,是時候該介紹出場了吧! 「開箱你的美好生活」現正召喚各路好物的開箱使者 🤩
Thumbnail
「欸!這是在哪裡買的?求連結 🥺」 誰叫你太有品味,一發就讓大家跟著剁手手? 讓你回購再回購的生活好物,是時候該介紹出場了吧! 「開箱你的美好生活」現正召喚各路好物的開箱使者 🤩
Thumbnail
以前考試最愛買參考書,參考書的編排通常是重點精華+題目+詳解。 不愛讀課本,只看重點精華就去做題目,以為這樣可以節省時間,做題目的時候模模糊糊,A好像也對,C看起來也很像...,根本沒搞清楚基本原理,又要重頭念一次。 才發現重點要自己整理,整理的過程是釐清內容和鞏固記憶最重要的環節。 整理是一
Thumbnail
以前考試最愛買參考書,參考書的編排通常是重點精華+題目+詳解。 不愛讀課本,只看重點精華就去做題目,以為這樣可以節省時間,做題目的時候模模糊糊,A好像也對,C看起來也很像...,根本沒搞清楚基本原理,又要重頭念一次。 才發現重點要自己整理,整理的過程是釐清內容和鞏固記憶最重要的環節。 整理是一
Thumbnail
作筆記,但千萬不要狂作筆記。這是在講啥?簡單說,如果真的想要讀懂一本書,至少讀懂一些,那筆記就是必要的行為。但整本書寫滿密密麻麻的筆記就沒必要,除非你是大學生,下個月要期中考。
Thumbnail
作筆記,但千萬不要狂作筆記。這是在講啥?簡單說,如果真的想要讀懂一本書,至少讀懂一些,那筆記就是必要的行為。但整本書寫滿密密麻麻的筆記就沒必要,除非你是大學生,下個月要期中考。
Thumbnail
我經常會覺得迷惑,雖然讀了很多不同的書籍作品,但在過了一段時間後好像沒多少內容能記得住、在和別人交談的時候也未必能夠說得出什麼。這或許是我太健忘,或是我未能明白書中所說的內容?因此我抱著以上的疑問翻閱本書,試圖了解別人是如何讀懂書文內容和記得住,進而能通過讀書來獲取智慧,幫助自己成長。
Thumbnail
我經常會覺得迷惑,雖然讀了很多不同的書籍作品,但在過了一段時間後好像沒多少內容能記得住、在和別人交談的時候也未必能夠說得出什麼。這或許是我太健忘,或是我未能明白書中所說的內容?因此我抱著以上的疑問翻閱本書,試圖了解別人是如何讀懂書文內容和記得住,進而能通過讀書來獲取智慧,幫助自己成長。
Thumbnail
#週日AMA 網友 Huang Jyun-Lin 發問: 󠀠 "" 󠀠 每次有人分享看書的訣竅,都說:「不要看完整本書」、「挑選有興趣的部分看」。但只要我嘗試這樣做,都會很不舒服: 󠀠 擔心會不會有什麼更深刻的知識我沒吸收、 可能漏掉作者想傳達的地方? 以及,沒看完整本書
Thumbnail
#週日AMA 網友 Huang Jyun-Lin 發問: 󠀠 "" 󠀠 每次有人分享看書的訣竅,都說:「不要看完整本書」、「挑選有興趣的部分看」。但只要我嘗試這樣做,都會很不舒服: 󠀠 擔心會不會有什麼更深刻的知識我沒吸收、 可能漏掉作者想傳達的地方? 以及,沒看完整本書
Thumbnail
小孩看似都把文章(課文)看完了,但到底看懂了多少?我們一步一步的帶著他們奠能力,不只是閱讀的當下需要花功夫,其實,閱讀前、中、後都有許多眉眉角角該注意。我們在資源班上課時,也會嘗試許多閱讀理解的方法,測試哪些小方法是對他們有幫助的。一起擴充閱讀工具吧! 【閱讀前】-找線索、舊經驗、有目標 在許多
Thumbnail
小孩看似都把文章(課文)看完了,但到底看懂了多少?我們一步一步的帶著他們奠能力,不只是閱讀的當下需要花功夫,其實,閱讀前、中、後都有許多眉眉角角該注意。我們在資源班上課時,也會嘗試許多閱讀理解的方法,測試哪些小方法是對他們有幫助的。一起擴充閱讀工具吧! 【閱讀前】-找線索、舊經驗、有目標 在許多
Thumbnail
字體太小、背景色太花、彈跳廣告視窗──各種罄竹難書的慘案,讓人讀來十分痛苦,忍不住高喊救命。短文就算了,如果要閱讀長篇資料、文獻,那真的是眼睛會瞎掉。
Thumbnail
字體太小、背景色太花、彈跳廣告視窗──各種罄竹難書的慘案,讓人讀來十分痛苦,忍不住高喊救命。短文就算了,如果要閱讀長篇資料、文獻,那真的是眼睛會瞎掉。
Thumbnail
接續上一篇文章: 優勢輸出可以應用的5個場景: 1.溝通表達 2.文章寫作 3.簡報規劃 4.視覺圖解 5.精準閱讀
Thumbnail
接續上一篇文章: 優勢輸出可以應用的5個場景: 1.溝通表達 2.文章寫作 3.簡報規劃 4.視覺圖解 5.精準閱讀
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News