diff --git a/_includes/index_toc.md b/_includes/index_toc.md new file mode 100644 index 00000000..a242ecc0 --- /dev/null +++ b/_includes/index_toc.md @@ -0,0 +1,62 @@ +{% comment %} +このファイルを各号の表紙の原稿から include して各号目次を生成します。 + +各号の表紙の原稿のフロントマターに articles_in_volume キーの配列として、下記のような一覧を記載します。この例では号数を 9999 としています。 + +articles_in_volume: +- id: /articles/9999/9999-Liquid-on-Jekyll + title: Liquid タグを使ってみた + authors: liquid さん + comment: るびまで Jekyll の Liquid タグを勉強する記事です。(難易度：例) +- url: https://www.example.com + title: 例示用のサイト + comment: 目次に例示用のサイトを含める例です。 + +対象の記事がこのレポトリにある場合、 +- id キーで記事の ID (原稿のファイルのパスから日付部分を除いたもの) を指定します (必須) +- title キーで目次に使用するタイトルを指定します。指定されていない場合は対象の原稿のフロントマターの title キーを利用します +- authors キーで目次に表示する著者リストを指定します (必須)。目次に著者を表示しない場合には `""` を指定します +- comment キーがある場合は目次に表示します + +対象の記事が外部のサイトの場合、 +- url キーでURLを指定します (必須) +- title キーで目次に使用するタイトルを指定します (必須) +- authors キーがある場合は目次に表示します +- comment キーがある場合は目次に表示します + +対象の記事の ID に号数が含まれる場合は、_includes/sidebar.html によってその記事のサイドバーにその号の目次が表示されます。/articles/first_step_ruby/FirstStepRuby などには表示されません。 + +{% endcomment %} +{% for x in page.articles_in_volume %} + +{% if x.id # idで指定された記事がこのレポジトリにある場合 %} +{% assign target = site.posts | find: "id", x.id %} +{% if target %} +{% if x.title %} +{% assign title = x.title %} +{% else %} +{% assign title = target.title %} +{% endif %} +### ![title_mark.gif]({{ base }}{{ site.baseurl }}/images/title_mark.gif) [{{ title }}]({{ base }}{{ target.url }}) +{% else %} +### ![title_mark.gif]({{ base }}{{ site.baseurl }}/images/title_mark.gif) 目次原稿に問題があります +⚠️ 目次原稿の `articles_in_volume` で `id` が {{ x.id }} の記事がありません… +{% endif %} + +{% unless x.authors %} +⚠️ 目次原稿の `articles_in_volume` で `id` が `{{ x.id }}` の記事の `authors` が指定されていません… +{% endunless %} + +{% else # 記事が外部サイトにありurlで指定されている場合 %} +### ![title_mark.gif]({{ base }}{{ site.baseurl }}/images/title_mark.gif) [{{ x.title }}]({{ x.url }}) +{% endif %} + +{% if x.authors and x.authors != "" %} +書いた人：{{ x.authors }} +{% endif %} + +{% if x.comment %} +{{ x.comment }} +{% endif %} + +{% endfor %} diff --git a/_includes/sidebar.html b/_includes/sidebar.html index 86ccda9c..a22a6e3a 100644 --- a/_includes/sidebar.html +++ b/_includes/sidebar.html @@ -1,8 +1,40 @@ -

-{% for post in site.tags.latest %} - {{ post.short_title }} -{% endfor %} -

+{% comment %} +_includes/index_toc.md に従って表紙原稿のフロントマターに記載された情報から各号目次をサイバーに生成します +{% endcomment %} +{% unless page.tags contains "index" %} +{% assign volume = page.id | split: "/" | slice: 2 %} +{% assign index_id = page.id | split: "/" | slice: 0, 3 | join: "/" | append: "/index" %} +{% assign toc = site.posts | find: "id", index_id %} +{% assign toc_posts = toc.articles_in_volume %} +{% if toc_posts.size > 0 %} +

{{ volume }}号

+ +{% endif %} +{% endunless %}

バックナンバー