用 Jekyll 和 Git 展示你的源碼
![](https://linuxstory.org/wp-content/uploads/2024/06/093318uoud175bj4d55zz5-800x400.jpg)
我是一個開源的超級粉絲。
我支持這項事業的一個小方法是從一開始就保持我的個人博客網站開放。我這樣做的部分原因是讓人們看到每個頁面背後的變化歷史。還因為當我開始使用 Jekyll 時,我沒有找到很多開源的 Jekyll 博客可以學習。我希望保持我的網站開放並公開我的嘗試和錯誤,可以為其他人節省很多時間。
Jekyll 的 page.path 變數
我實現這一目標的方法之一是將我發布的每一個條目鏈接到其原始的 Markdown。Jekyll 的變數 中正好有一個需要的工具:page.path
。這個變數包含每個頁面的原始文件系統路徑。官方的描述甚至強調了它的作用是鏈接回源!
在一篇文章的 Markdown 文件中列印 {{page.path }}
,可以得到類似這樣的結果:
_posts/2021-10-10-example.md
假設該文章的源代碼存在於這個路徑:
https://example.com/ayushsharma-in/-/blob/master/_posts/2021-10-10-example.md
如果你在任何文章的 page.path
前加上 https://example.com/ayushsharma-in/-/blob/master/
,它就會生成一個返回其源碼的鏈接。
在 Jekyll 中,生成這個完整的鏈接看起來像這樣:
<a href="{{ page.path | prepend: site.content.blog_source_prefix }}" target="_blank">View source</a>
就是這麼簡單。
Jekyll 和開放 Web
現代 Web 是一種錯綜複雜的多層次技術,但這並不意味著它必須讓人摸不清。有了 Jekyll 的變數,你可以確保你的用戶可以,了解更多關於你是如何建立你的網站的,如果他們願意的話。
你可以在我的個人博客上看到真實的例子:滾動到底部的查看源碼鏈接。
本文改編自 ayush sharma 的筆記,並經許可轉載。
via: https://opensource.com/article/21/12/reveal-source-code-jinja2-git
作者:Ayush Sharma 選題:lujun9972 譯者:geekpi 校對:wxy
本文轉載來自 Linux 中國: https://github.com/Linux-CN/archive