Closed Aritaka-hub closed 1 week ago
今の構想はサイドメニューを付けて各情報のアクセスを容易にする変更を考えていて
サイドメニューというのはサイト全体の共通? pi zero チュートリアルページ https://tutorial.chirimen.org/pizero/ 単体に閉じたもの?それとも pizero 専用のサイドメニューのあるページの右に既存の色んなページを埋め込むフレーム的なもの?
目次にあたるものが折りたたみで再度 (両端) に表示できるという形であれば docusaurus などを使うだけで自動的にチュートリアル全体の目次 (現在ページがそのどの部分か) と各ページ内での目次が共に左右に折りたたみで表示できるようになったりします(例は docusaurus 自身のもの https://docusaurus.io/docs/next/installation とか react, svelte その他フレームワークの docs サイト) が、そういうシステム的なものを使ったりしますか?
pi3+ の方は導入ページ https://tutorial.chirimen.org/raspi/ があって配下に内容毎に分かれるという構成を取ることで必要な情報にアクセスし安くということをしていました。また、パーツリスト(およびそこから続く examples) などのようなものはサイトトップの共通ヘッダに入れる事でケアしようという設計でした。
docusaurus 的なものでチュートリアル全体/ページ内のナビゲーションを改善するのは (ドメイン移転の作業先として止まってしまってますが) サイトのシステム変更とか構成変更で過去にも何度か議論してましたがそういう話とは別ですか?
個人的にはいまのチュートリアルサイトで教えるときにやりにくいと思っているのは
これは多分、Pizero 配下のページだけ直せば済むもの、ページ分割と共にサイトのヘッダやサイドバー(サイドメニュー)などの導入/更新でできるもの、複数デバイス共通ページの再整理まで必要なものと別れるというイメージですが、どの辺りを解消するためにどうやるのかというイメージが分かる形で説明なりラフスケッチなりプレビューなり見られると嬉しいです。
本Issueではチュートリアル全体 (#75) の改修とは分けて、pi zero チュートリアルページの改修を想定します。 具体的には、/pizero/ 配下を部分的に mdBook https://github.com/rust-lang/mdBook で、あるいは Docusaurus で書き出す、部分的でインクリメンタルなリリースを考えています。
Pizero 配下のページでは以下が課題という認識です:
- 頻繁にアクセスするページ/ツールへのリンク集的なものが (特にpizero) ない
どうやるのかというイメージとしては @Aritaka-hub としてはこのように分割して、目次が共に左右に折りたたみで表示できるようにしていく、という想定です (分割した Markdown のコードがオンライン上に見当たらなかったのでお手数ですが後で共有してもらえれば > @Aritaka-hub):
https://aritaka-hub.github.io/kataria.github.io/pizero/book/
@kou029w コメントありがとうございました。 マークダウンのコードですが GitHub にアップ出来ていませんでした。
https://github.com/Aritaka-hub/kataria.github.io/tree/main/docs/pizero/src こちらに一式アップ出来ました。色々不慣れですみません。
現在のチュートリアルで、特に遠隔講義を行う時にサイトのどこが分からないかを共有しやすくする目的で分割を行っています。また CHIRIMEN Generic の内容も統合して情報集約を行い初学者にも読みやすくなればと思い構成してみました。 まだ情報量の精査など十分ではないかもですが、方向性の共有が出来れば幸いです。
@gurezo 情報共有ありがとうございます、こちらも作業の参考にさせて頂きます。
@gurezo 構成参考にさせていただきます! ありがとうございます! @Aritaka-hub も共有ありがとうございます!
現状としては
です このあとマージしてみます お手数おかけしますが問題無さそうかどうか https://tutorial.chirimen.org/pizero/ をご確認ください〜 > 皆様
@satakagi @kou029w
PiZero版のチュートリアルサイトを WIMC+ の各地のメンターや学校関係者の方も見る(使用する)機会が増えてきた事もあり、より使い勝手を良くするための UI 変更をメインとしたリニューアルの作業をしたいと思います。
今の構想はサイドメニューを付けて各情報のアクセスを容易にする変更を考えていて、内容変更までは考えていませんが、リニューアル作業をしてみて色々とご意見いただけるとありがたいです。プレビュー版など出来たらまた相談させてください。