本ページは DojoCon Japan 公式Webサイトの公開リポジトリです。
本READMEでは、公式Webサイトの更新方法を目的別にまとめています。
(:octocat: 前年度からリポジトリを引き継いで再活用しています)
どこを更新するにせよ Webブラウザが一番簡単 だと思います...!! 😆
以上で完了です。提案された修正内容は運営チームによって再確認され、問題なければ提案された内容が反映されます。もし修正内容に不具合があっても運営側で気付いて修正するので、まずはお気軽に提案してみてください :wink:
_data
フォルダ内に ファイル名.yml
という YAML ファイルがあり、このファイルを修正すると Session 情報や Member 情報などを更新できます。
なおそれぞれの YAML ファイルは次のような形式で書かれています。
# events.yml のデータ例
- title: ニンジャ大博覧会
text: ニンジャ大博覧会は、CoderDojoに参加する子どもたち(ニンジャ)によるオンラインと現地の2箇所で開催する作品展示会です。プログラミング作品はもちろん、マインクラフト作品もOK。ぜひみんなの作品を見せてください、楽しみにまってます!
img: /img/2023/event/ninja-big-expo.jpg
time: オンライン&現地
tag: 要申し込み
url: /expo/
追加・修正したい箇所に応じて、下記リンク先を上記の修正手順に沿って更新できます。
events.yml
: イベント情報を更新したいmembers.yml
: スタッフ情報を更新したいsessions.yml
: セッション情報を更新したいsponsors.yml
: スポンサー情報を更新したいworkshops.yml
: ワークショップ情報を更新したいprojects.yml
: ニンジャ大博覧会の作品情報を更新したいローカル環境でWebサイトを修正・確認したい場合は 以下のいずれかの方法 でローカルサーバーを立ち上げてください。
# 下記コマンドでローカル環境にWebサーバーが立ち上がります
$ docker-compose up
無事にローカルサーバーが立ち上がったら、http://localhost:4000/ にアクセスしてWebサイトを修正・確認します。
# Dockefile から dojocon-japan-2024 イメージを作成する
$ docker build -t dojocon-japan-2024 -f Dockerfile .
# 下記コマンドでローカル環境にWebサーバーが立ち上がります
$ docker-compose up
無事にローカルサーバーが立ち上がったら、http://localhost:4000/ にアクセスしてWebサイトを修正・確認します。
エラーなどで困ったら Rails Girls インストール・レシピを見るのがオススメです。
Ruby がインストールできれば十分で、 Rails のインストールは不要 です。
# macOS の場合: Homebrew ( https://brew.sh/index_ja ) 経由がオススメ
$ brew install rbenv ruby-build
# Linux の場合: https://github.com/rbenv/rbenv#readme に沿って rbenv をインストール
$ sudo apt install rbenv # Debian, Ubuntu 系のディストリビューションの場合
# Windows の場合: 以下の Rails Girls インストール・レシピに沿ってインストール
# https://railsgirls.jp/install
# Ruby 3.2.x をインストール
$ rbenv install 3.2.0
# Ruby が入っていることを確認
$ ruby --version
# 必要なライブラリをインストール
$ bundle install
# ローカルサーバーを立ち上げる
$ bundle exec jekyll server
無事にローカルサーバーが立ち上がったら、http://localhost:4000/ にアクセスしてWebサイトを修正・確認します。
内部リンクのミスや alt
属性の記入忘れなどは次のコマンドでテストできます。(修正例を見る)
# ローカルサーバーの立ち上げは不要です
$ bundle exec rake test
テスト内容の詳細は Rakefile
をご参照ください。
上記テストは GitHub Actions 上でも動いています。GitHub Actionsで動かしているタスクは .github/workflows
ディレクトリから確認できます :eyes: :white_check_mark:
This web application is developed with many other brilliant works!
Check out the followings if you are interested in. :wink:
The texts and images, such as descriptions and thumbnails, company logos and staff photos, are owned by its content holder. Contact its owner, like the maintainer of linked external website or social account, before using them. 🔐
The libraries like RubyGems used in this website have their own licenses. Say, this website uses Jekyll, created by The Jekyll Team licensed under The MIT License. Thanks for their great works to make this website published! 💖
The source codes, such as HTML/CSS/JavaScript and Ruby codes not declared before, are published under The MIT License. Feel free to refer, copy, or share them. And contact us if you find something unclear.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
DojoCon Japan 2024 実行委員会 & 一般社団法人 CoderDojo Japan (@coderdojo-japan).