Skip to content

Latest commit

 

History

History
executable file
·
135 lines (102 loc) · 5.16 KB

README.md

File metadata and controls

executable file
·
135 lines (102 loc) · 5.16 KB
Raw

CoderDojo Web

CoderDojoは小中学生のためのプログラミング道場

はじめに

このリポジトリは、CoderDojo TokyoのWebサイトのために作られました。他のDojoでもフォークして使えるようになっています。改良点などあれば、どしどしプルリクエストください。不明な点・質問は、Issuesへどうぞ。

サイトの運用

Facebookページが運用されていて、開催情報をFacebookイベントとして公開していることが、前提条件です。また、メンターの出席管理も、Facebookイベントで行います。

日常的な更新

  • 開催情報をFacebookイベントとして登録 (2,3ヶ月分を事前に登録しておくとGood) Facebook Event
  • 各メンターは、参加可能な日程で上記イベントに参加表明します
  • メンターが増えた場合は、Parse.comのデータベースに追加 (今のところ手動で)

デプロイが必要な更新

  • 文言の変更 0. src/index.html を書き換えます。 0. $ gulp html && parse deploy
  • デザイン変更 0. src/css/ 以下を書き換えます。 0. $ gulp css && parse deploy

ファイル構成

ビルドファイルはリポジトリに含まれません。cloud,publicなどは、フォークした後、手元で$ npm installすると自動生成されます。(詳しくは後述)

  • cloud/: Cloud Code ※自動生成
  • public/: Parse.comでホスティングする静的ファイル ※自動生成
  • bower_components/: ※自動生成
  • node_modules/: ※自動生成
  • config/: Parse.comへの接続する設定データを格納 ※秘密情報のためgitに含めず
  • doc/: ドキュメント関連
  • task/: gulp.jsのサブタスク
  • src/: ソース
    • coffee/
      • ng: AngularJSのコントローラなど
      • parse Parse.comのクラス、ジョブほか
    • css
  • bower.json
  • package.json
  • gulpfile.coffee
  • README.md: このドキュメント

サイトをビルドするには

上記の「日常的な更新」以外の作業をするには、環境構築が必要です。また、最初にサイトを作る場合にも必要になります。

使っている技術、サービス

ローカルの準備

  1. 環境を確認
  2. このリポジトリをフォーク
  3. ターミナルでローカルディレクトリを開く: $ cd path/to/dir
  4. 依存ライブラリのインストールとビルド: $ npm install
  5. Watch: $ gulp watch
  6. 作業開始!

Facebookの準備

  • CoderDojoのFacebookページを開設
  • 開催情報をFacebookイベントとして登録
  • Facebook Appの作成 Facebook App

Parse.comの準備

  1. Parse.comのアカウントを取得
  2. 空のアプリケーションを作成
  3. Facebook Appの設定をSettingクラスに登録。keyに次のふたつが設定されたものが必要。
    • facebook_app_id
    • facebook_app_secret
  4. メンター情報をMentorクラスに登録 (今のところ手動で) メンター情報

デプロイ

Parse.comのCloud Codeと、ホスティング機能を使います。まず、コマンドラインツールをインストールしておきます。

$ curl -s https://www.parse.com/downloads/cloud_code/installer.sh | sudo /bin/bash

config/global.jsonとして、下記の内容のファイルを置きます。環境に合わせて、適宜書き換えてください。(同じDojoの人がすでに作っていたら、それをコピーする方が早いかも)

{
  "applications": {
    "<アプリケーション名>": {
      "applicationId": "<アプリケーションID>", 
      "masterKey": "<マスターキー>"
    }, 
    "_default": {
      "link": "<アプリケーション名>"
    }
  }, 
  "global": {
    "parseVersion": "1.2.19"
  }
}

次のコマンドを実行すると、cloud, publicフォルダ内がParse.comと同期・デプロイされます。

$ parse deploy

ジョブの自動実行

Parse.comのサイトにアクセスして、"Cloud Code > Scheduled Jobs"を開きます。"Schedule a Job"ボタンをクリックして、syncMeetupsをジョブに登録します。実行頻度は、毎時の00分とします。(もっと少ない頻度でもOK)

Scheduled Jobs