Kurt/在 Github 展示你最新的 Medium 文章

Created Thu, 14 Jul 2022 10:25:16 +0800 Modified Wed, 02 Nov 2022 05:33:26 +0000

在 Github 展示你最新的 Medium 文章

簡介

上次介紹了 so-stats,將你的 Stack Overflow 數據顯示在 Github 個人頁面(還沒使用過的捧友 -> 手刀前往)。

這次要講的是另一個 side project - medium-story,看專案名稱就知道他跟 Medium 服務有關; 沒錯!這次的小專案也是用來美化你的 Github 個人頁面的,只需要使用一行網址,就可以產生你最新的 Medium 文章在你的個人頁面。

此專案使用 rss 取得你近期最新的 10 篇文章,然後回傳一張 svg 圖片給你,讓你放在 Github profile 中,或是任何可以放圖片的部落格!

先看成果

Demo first

使用方式

so-stats 一樣,只需要短短兩步驟!

  1. 找到你的 Medium username

Find out your Medium username

  1. 將 ?username= 參數改成第一個步驟找到的值

你的網址會看起來像這樣:https://medium-story.vercel.app/api?username=@s09001

先將它貼在瀏覽器中,你就會看到結果如下 ⇓

Example

將他放在 Github profile 或是任何地方

複製以下 markdown 語法並貼在你的 profile 頁面

[![My Medium story](https://medium-story.vercel.app/api?username=@s09001)](https://github.com/kurt-liao/medium-story)

當然,你也可以用 html tag

<a href="https://github.com/kurt-liao/medium-story">
  <img
    height="200"
    src="https://medium-story.vercel.app/api?username=@s09001"
  />
</a>

選擇性設定

我有提供一些選擇性的特性,看下去吧!

指定文章

上文有提到這個專案是使用 rss 去取得你最近的 10 篇文章,所以我設置了 index 參數,讓你可以指定你要顯示最新一篇、還是第二篇…的文章, index 的範圍從 0~9,若沒特別設定,則永遠取得的是最新的一篇。

Example

隱藏特定資訊

你可以傳 &hide= 參數隱藏你不想顯示的資訊(使用 , 做分隔)

&hide=img,date,desc,category

![My latest medium story](https://medium-story.vercel.app/api?username=@s09001&hide=img,date)

Example

取得文章連結

為了讓你的網頁觀看者在點擊該 svg 圖片時,可以自動連結到你的 Medium 文章畫面,所以增加了此參數,你只要設定 is_link=true,該次的 request 回傳的就不會是一張 svg,而是你的文章連結

tag 中使用此特性 ⇓

<a href="https://medium-story.vercel.app/api?username=@s09001&is_link=true">
  <img
    height="200"
    src="https://medium-story.vercel.app/api?username=@s09001"
  />
</a>

或是使用 markdwon 語法 ⇓

[![My Medium story](https://medium-story.vercel.app/api?username=@s09001)](https://medium-story.vercel.app/api?username=@s09001&is_link=true)

自行佈署

若你想自己佈署一個服務的話,請參考 Vercel 佈署


最後,不免俗的,歡迎提供任何建議 🎉,還有 ⭐

🐛Issue Report & Feature Request✨