DUICUO

JekyllとGitでソースコードを公開する

[[441251]]

各ページを元のソース コードにリンクして、Web サイトをオープンに保つ方法を説明します。

私はオープンソースの大ファンです。

この活動を支援する小さな方法の一つとして、個人ブログサイトを最初から公開しています。これは、各ページの変更履歴を人々に見てもらいたいという思いもあります。また、Jekyllを使い始めた頃は、参考にできるオープンソースのJekyllブログがあまりありませんでした。サイトを公開し、試行錯誤を共有することで、他の人の時間を節約できるのではないかと考えたのです。

Jekyllのpage.path変数

これを実現した方法の一つは、公開した各エントリを元のMarkdownにリンクすることでした。Jekyllには、このための便利なツールpage.pathがあります。この変数には、各ページの元のファイルシステムパスが格納されます。公式の説明でも、この変数が元のページへのリンクとしての役割を強調しています。

Markdown ファイルに{{page.path }}を印刷すると、次のような結果が生成されます。

  1. _posts / 2021 - 10 - 10 - example . md

この記事のソース コードが次のパスに存在すると仮定します。

  1. https : //example.com/ayushsharma-in/-/blob/master/_posts/2021-10-10-example.md

任意の記事のpage.pathの前にhttps://example.com/ayushsharma-in/-/blob/master/を追加すると、そのソース コードに戻るリンクが生成されます。

Jekyll では、この完全なリンクを生成すると次のようになります。

  1. <a href = "{{ page.path | prepend: site.content.blog_source_prefix }}" target = "_blank" > View source </a>

とても簡単です。

ジキル博士とオープンウェブ

現代のWebは複雑で多層的なテクノロジーですが、だからといって理解不能である必要はありません。Jekyllの変数を使えば、ユーザーが望むなら、Webサイトの構築方法について詳しく知ることができます。

実際の例は私の個人ブログでご覧いただけます。ソース コードの表示リンクについては、一番下までスクロールしてください。