How to make FA25 Kannai site¶

mkdocs.yml¶

Student template¶

# Replace the text below to customize your site
site_name: Your name - Fab Academy
site_description: Fab Academy documentation site for Your Name
site_author: Your name
copyright: Copyright 2023 Your name - Creative Commons Attribution Non Commercial

site_url: http://fibasile.fabcloud.io/fabacademy-student-template/

extra:
  # Set your own social media below (or remove)
  social:
    # For other social icons at https://squidfunk.github.io/mkdocs-material/setup/adding-social-links/
    - icon: fontawesome/brands/instagram
      link: https://instagram.com/fabacademany
    - icon: fontawesome/brands/facebook
      link: https://facebook.com/fabacademany
    - icon: fontawesome/brands/twitter
      link: https://twitter.com/fabacademany
    - icon: fontawesome/brands/linkedin
      link: "https://linkedin.com/in/academany"

theme:
  name: material
  palette:
    # try other colors https://squidfunk.github.io/mkdocs-material/getting-started/#primary-colors
    primary: deep
    accent: indigo
  font:
    # See available fonts at https://fonts.google.com/
    text: Ubuntu
    code: Ubuntu Mono
  icon:
    logo: material/school
  favicon: images/favicon.svg
  features:
    - navigation.tabs
    - navigation.instant

plugins:
  - search
  - git-revision-date-localized:
      fallback_to_build_date: true
      # Read more: https://timvink.github.io/mkdocs-git-revision-date-localized-plugin/options/#enabled
      enabled: !ENV [ENABLED_GIT_REVISION_DATE, False]

markdown_extensions:
  - extra
  - smarty
  - admonition
  - codehilite:
      guess_lang: false
  - toc:
      permalink: true

pre-FA25¶

# サイト名、説明、著者、著作権情報の設定
site_name: FabLab Kannai - Fab Academy 2025  # サイトの名前
site_description: Fab Academy documentation site for FabLab Kannai  # サイトの説明
site_author: Yuichi TAMIYA  # サイトの作者名
copyright: Copyright 2025 Yuichi TAMIYA - Creative Commons Attribution Non Commercial  # 著作権表示 フッターに表示される


# 追加のCSSファイルを指定
extra_css:
  - stylesheets/extra.css  # 追加のカスタムCSSファイルを適用
  - stylesheets/svg.css # SVGを使うためのCSSファイル

# p5.jsライブラリを使用するために、CDNからJavaScriptファイルを読み込み
extra_javascript:
#  - https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.4.0/p5.js
  - https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.10.0/p5.min.js 



# テーマの設定
theme:
  name: material
  font:
    text: SemiBold 600  # テキストフォントの設定
    code: Ubuntu Mono  # コードフォントの設定
  logo: images/logo2022-tate-g.png  # ロゴアイコンの設定
  icon:
    favicon: images/favicon.ico  # ファビコンの設定　　https://favicon-generator.mintsu-dev.com/
  features:
    - navigation.tabs  # ナビゲーションをタブで表示
    - navigation.instant  # ナビゲーションが即座に切り替わる機能
  #  - navigation.top  # ナビゲーションバーをトップに表示（コメントアウト）
  #  - navigation.sections  # ナビゲーションをセクションで分ける（コメントアウト）

#nav: #　　これを設定すると features: navigation.tabsの自動生成が機能しなくなる
#    - Home: index.md 
#    - About: about.md


markdown_extensions:

  - pymdownx.tabbed
  - pymdownx.superfences #linenumsに必要
  - pymdownx.highlight:
  #    linenums: true #コメントアウトのままで必要な時にだけ都度linenums="1"と書けばよい
  - admonition
  - pymdownx.details #admonitionの折りたたみに必要
  - attr_list #![](path/to/image.jpg){width=300}で表示される大きさを変える