エフスタ!! あなたも恋する♡GitHub勉強会 GitBookなどのGitHubの周辺技術

Transcript

1. Τϑελ
   ͋ͳͨ΋࿀͢Δὑ(JU)VCษڧձ
   (JU#PPLͳͲͷ(JU)VCͷपลٕज़
   
   
   1  ౔
   
   Φʔϓϯ઒࡚$PEF
   GPS
   ,BXBTBLJ
   খມ
   ത࢘
   
2. Who  am  I 小俣  博司  / OMATA, Hiroshi オープン川崎/Code for Kawasaki 主宰 神奈川県川崎市出身、川崎市在住 デベロッパー・エンジニア歴30年以上の経験を持ち、ハー ドウェアへの組み込み系プログラムやデータ処理等を得意 としている。 日本の自治体で初めて「オープンデータ」に取り組んだ福 井県鯖江市の取組に当初より携わり、2014年9月から翌3 月まで、Code for Japanのフェローとして福島県浪江町 役場に勤務し町民向けタブレットアプリ開発に携わった。 Code for Japanが昨年まで実施していた井戸端会議の世 話人のひとり｡ 大学の研究員として、データ分析・解析、シビックテック やオープンデータ/オープンガバメントについて精力的に 活動をしている。
3. たまにはエンジニアっぽい ことも 3
4. SPIDERSS  For  Android  (2010) 4 h8ps://techcrunch.com/2010/03/08/spiderss-­‐‑for-­‐‑android-­‐‑browser-­‐‑rss-­‐‑ reader-­‐‑and-­‐‑social-­‐‑network-­‐‑update-­‐‑aggregator-­‐‑in-­‐‑one/
5. G空間情報センター 5 h8ps://www.geospatial.jp/
6. 6 h8p://koriyama.tohokutechdojo.org/
7. (JU)VCͷपลٕज़ •  GitHubとドキュメントと •  GitとMS Officeと •  GitHubとWebサイトと •  GitHubとタスクと •  GitHubとチャットと •  GitHubと継続的インテグレーション(CI)と 7
8. GitHubとドキュメントと 8
9. GitBook GitBookは2014年に作成された電子書籍サービスです。 Markdownで書かれたテキストファイルを、gitで管理し、 ウェブ、PDF、epub、mobi形式に出力することが出来ま す。 クラウドサービスであるGitBook.comとパソコンで動作さ せるコマンドラインツールの２つがあります 9
10. Features •  MarkdownまたはAsciiDocで記述 •  出力フォーマット: o  ウェブサイトまたは電子ブックpdf、epub、mobi） •  多言語化 •  用語集/用語集 •  カバー •  変数とテンプレート •  コンテンツ参照 •  プラグイン •  テーマ 10 h8ps://github.com/GitbookIO/gitbook
12. GitBook.com 12
13. GitBook.com •  クラウドの電子書籍作成統合サービス •  フリーミアムモデル •  ブラウザー上で、編集、閲覧することが可能 •  統合編集ツールGitBook Editor 13
14. GitBook  Dashboard 14
15. フリーミアムモデル 15
16. Bookメイン 16
17. 統合編集ツール   GitBook  Editor 17
18. ウェブ閲覧 18
19. GitBookクライアント 19
20. GitBookクライアント •  GitBookクライアントはコマンドラインツール •  Node.jsライブラリ •  GitHub(GitbookIO/gitbook)にオープンソースとして公開 o  https://github.com/GitbookIO/gitbook 20
21. GitbookIO 21 h8ps://github.com/GitbookIO/gitbook
22. Install  and  Se8ing •  Local Installation o  NodeJS (v4.0.0 and above is recommended) o  Windows, Linux, Unix, or Mac OS X •  Install with NPM $ npm install gitbook-cli –g $ gitbook install $ gitbook --version CLI version: 2.3.0 GitBook version: 2.6.7 22
23. Create  Book GitBook初期ファイル作成 $ gitbook init 下記を自動生成 ├── README.md └── SUMMARY.md ローカルプレビュー $ gitbook serve HTMLビルド $ gitbook build 23
24. h8p://localhost:4000 24
25. Directory  Structure . ├── book.json ………………. 設定ファイル ├── README.md ………………. 序文 (必須ファイル) ├── SUMMARY.md ………………. 目次 ├── GLOSSARY.md ………………. 用語/用語集 └── chapter-1/ ………………. 章ディレクトリ ├── README.md ………………. 章の序文 (必須ファイル) └── something.md ……………….章の本文 25
26. Summary   (SUMMARY.md) # Summary * [Part I](part1/README.md) * [Writing is nice](part1/writing.md) * [GitBook is nice](part1/gitbook.md) * [Part II](part2/README.md) * [We love feedback](part2/feedback_please.md) * [Better tools for authors](part2/better_tools.md) 26
27. Pages # Title of the chapter This is a great introduction. ## Section 1 Markdown will dictates _most_ of your **book's structure** ## Section 2 ... 27
28. Glossary   (GLOSSARY.md) ## Term Definition for this term ## Another term With it's definition, this can contain bold text and all other kinds of inline markup ... 28
29. 多言語化 # Languages * [English](en/) * [French](fr/) * [Español](es/). 29
30. 電子書籍ファイルに出力 PDF file $ gitbook pdf ./ ./mybook.pdf ePub file $ gitbook epub ./ ./mybook.epub Mobi file $ gitbook mobi ./ ./mybook.mobi 30
31. Plugin 31 h8ps://plugins.gitbook.com/
32. How  to  install  plugin? $ vi book.json { "plugins": ["myPlugin", "anotherPlugin"] } $ gitbook install 32
33. Documentation 33 h8p://toolchain.gitbook.com/
34. HTML作成例 34 h8ps://homata.gitbooks.io/monaca_basic_course/content//
35. PDF作成例 35
36. GitとMS  Officeと 36
37. MS  Wordファイルの管理 MS Wordファイルを管理する場合は「git diff」の時にプレーン テキストに変換して差分を取れるようにする •  docx2txt o  http://docx2txt.sourceforge.net/ •  git diff wrapperの設定で「git diff」の時に「docx2txt」でプ レーンテキストの変換する 37
38. MS  Excelファイルの管理 MS Excelファイルを管理する場合は「git diff」の時にプレーン テキストに変換して差分を取れるようにする •  tokuhirom/git-xlsx-textconv o  https://github.com/tokuhirom/git-xlsx-textconv •  git diff wrapperで「git diff」の時に「git-xlsx-textconv 」で 変換する。 38
39. GitHubとWebサイトと 39
40. GitHub  Page 40 h8ps://pages.github.com/
41. GitHub  Page •  GitHub Pagesは、GitHubが提供するホスティングサービス です。無料でWebサイトを公開することが出来ます。 •  基本的に静的なウェブページです。データベースは使用でき ない •  ユーザ名で紐付けられるユーザサイト（User site）と、リポ ジトリに紐付けられるプロジェクトサイト（Project site）が 作成できる •  HTML、JavaScript、CSSを作成しれGitHubのレポジトリに 登録すれば良い。 •  GitHub PageはJekyll対応 o  Rubyで作成された静的なWebサイトの生成ツール o  ブログ・サイト等が作成できる o  GitHub: https://github.com/jekyll/jekyll o  URL: https://jekyllrb.com 41
42. GitHub  Page •  GitHub Pages用のリポジトリの作成 o  https://github.com/username/username.github.io •  レポジトリを取ってくる o  $ git clone •  ウェブページの作成 o  HTML,JavaScrit,css …. •  GitHubへプッシュ o  $ git add o  $ git commit o  $ git push •  GitHub Pagesへアクセスして確認 o  ユーザサイトの場合「http://username.github.io」 o  プロジェクトサイトの場合「http://username.github.io/repository」 •  独自ドメイン名 (例) hogegeo.com o  CNAMEファイルを作成しドメイン名を登録する 42
43. GitHubとタスクと 43
44. かんばん GitHubのIssueでかんばん形式のタスク管理が出来る •  GitHub Projects o  GitHubの機能 (Issueとはタスクは別) •  Waffle.io o  https://waffle.io/ •  ZenHub o  https://www.zenhub.com/ 44
45. GitHub  Project 45
46. GitHub  Issue 46
47. Waffle.io 47 h8ps://waffle.io/
48. Waffle.ioの料金プラン 48 h8ps://waffle.io/pricing
49. ZenHub 49 h8ps://www.zenhub.com/
50. ZenHubの料金プラン 50 h8ps://www.zenhub.com/pricing
51. GitHubとチャットと 51
52. Gi8er 52 h8ps://gi8er.im/ GitHubと連携するチャットサービス
53. Gi8erの料金プラン 53 h8ps://gi8er.im/#pricing-­‐‑panel
54. GitHubと継続的インテグ レーション(CI)と 54
55. Travis  CIで自動テスト 「Travis CI」はGitHubと連携した継続的インテグレーション (Continuous Integration)サービスです。 •  プログラムの自動ビルドや自動テスト処理を実行 •  テスト結果をメールなどに通知 •  ビルドしたプログラムをデプロイ 55
56. Travis  CI 56 h8ps://travis-­‐‑ci.org/
57. Travis  CIの料金プラン 57 h8ps://travis-­‐‑ci.com/plans オープンソースソフトウェア向けには無償