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

這內容有問題嗎？

這也是一個蠻常見的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的服務來解決問題，像是誠華OCR，OnlineOCR，EasyScreenOCR。但我自己最常用的反而是Google Keep：

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