以下のフォルダ内の各ファイルを編集することで、実施できます。
\pmconfjp2018\source\assets\images
\pmconfjp2018\source\assets\stylesheets
\pmconfjp2018\source\assets\javascripts
以下のフォルダ内の .slim
拡張子のファイルを編集することで、実施できます。
\pmconfjp2018\source
以下のフォルダ内の .yml
拡張子のファイルを編集することで、実施できます。
\pmconfjp2018\data
記事のファイル名フォーマットは、YYYY-MM-DD-TITLE.html.md
となっています。
例) 2018-11-10-first-post.html.md
このファイル内では、以下のフォーマットに沿って記述する必要があります。
※dateはファイル名の日付と一致している必要があります。
categoryに eventreport
を指定すると、http://2018.sendaiitfes.org/articles/categories/eventreport.html に記事が表示されます。
以下のフォルダ内の各ファイルを編集することで、実施できます。
\pmconfjp2018\source\tips
ファイル名は TITLE.html.md
というフォーマットである必要があります。
例) group-work-guide.md
また、ファイル内では以下のフォーマットに沿って記述する必要があります。
軽微な更新であれば、開発環境を用意せずに更新が可能です。 一番簡単な更新手順としては、以下となります。
- Web画面上で、編集したい箇所を特定。
- Web画面上で、ソースコードの右上にある鉛筆アイコン(Edit this file)をクリック。
- Web画面上で、編集。
- Web画面上で、画面下部にあるCommit changesに、変更概要を記入し、「Commit changes」ボタンをクリック。
- 2分後ぐらいに、自動で本番環境に反映 https://travis-ci.org/fullvirtue/pmconfjp2018 を確認し、
build
がpassed
になることを確認。もしerrored
になった場合は、画面下部に赤字でエラーになった箇所が表示されるので、エラー内容を確認し修正後、4.に戻る。 - 本番環境にアクセスして、表示内容を確認。
手元のテキストエディタ等で更新したい場合は、git の環境を用意する必要があります。
Windows環境、Mac環境ともに、以下の手順となります。
- SourceTree (無料) をダウンロードし、インストール。 https://ja.atlassian.com/software/sourcetree
- SourceTree を起動。
- SourceTree上で、このリポジトリを clone。
- 最新版の
master
ブランチをpull
。 - 任意のテキストエディタを開き、編集したい箇所を特定。
- 任意のテキストエディタ上で、編集し、保存。
- SourceTree上で、
commit
&push
。 - 2分後ぐらいに、自動で本番環境に反映 https://travis-ci.org/fullvirtue/pmconfjp2018 を確認し、
build
がpassed
になることを確認。もしerrored
になった場合は、画面下部に赤字でエラーになった箇所が表示されるので、エラー内容を確認し修正後、保存し、4.に戻る。 - 本番環境にアクセスして、表示内容を確認。
手元にデモ環境を用意し、正しく表示が出来ることを確認してから本番環境に反映したい場合、開発環境そのものを構築することになります。
Mac環境では、以下の手順となります。
Homebrewへのパスをbash_profileに追記する。
$ vim ~/.bash_profile
export PATH=/usr/local:$PATH Homebrewでインストールされるソフトウェアの保存先が無ければ作成する。
$ sudo mkdir /usr/local/
Homebrewをインストールする。
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
先ほど編集したbash_profileを再読み込み。
$ source ~/.bash_profile
インストールできているか確認
$ brew -v
Homebrew 0.9.5
(20180908-riku編集 ざっくり書いてます)
こちら参考にお願いします http://qiita.com/issobero/items/e0443b79da117ed48294
2-2を参考にローカル環境に本リポジトリをクローン
ルートディレクトリ(/pmconfjp2018)で以下のコマンドを実行
rm -rf ~/.nvm
git clone https://github.com/creationix/nvm.git ~/.nvm
cd ~/.nvm
git checkout `git describe --abbrev=0 --tags`
source ~/.nvm/nvm.sh
nvm install "$TRAVIS_NODE_VERSION"
npm install
■最初の1回目&2回目以降はここから
bundle exec middleman build --verbose
■デプロイするときだけ実行するので、ローカルではやらないのが普通
[ "$TRAVIS_BRANCH" == "master" ]
[ $GH_TOKEN ]
bundle exec middleman deploy
/pmconfjp2018/build の中にサイトができてるはず。
上記コマンドの
bundle exec middleman build --verbose
を実行するたびに、変更が反映されたものがビルドされる。