{"id":14982441,"url":"https://github.com/manabuyasuda/equip","last_synced_at":"2025-10-29T13:30:17.844Z","repository":{"id":83098466,"uuid":"52107455","full_name":"manabuyasuda/equip","owner":"manabuyasuda","description":"Gulp, EJS, Sass(ECSS), Aigis, iconfont","archived":false,"fork":false,"pushed_at":"2017-03-24T01:36:38.000Z","size":384,"stargazers_count":35,"open_issues_count":14,"forks_count":12,"subscribers_count":3,"default_branch":"v2","last_synced_at":"2025-02-02T01:32:05.870Z","etag":null,"topics":["aigis","ejs","sass"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manabuyasuda.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-02-19T18:22:56.000Z","updated_at":"2023-03-17T08:48:03.000Z","dependencies_parsed_at":"2023-03-12T17:29:30.575Z","dependency_job_id":null,"html_url":"https://github.com/manabuyasuda/equip","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manabuyasuda%2Fequip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manabuyasuda%2Fequip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manabuyasuda%2Fequip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manabuyasuda%2Fequip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manabuyasuda","download_url":"https://codeload.github.com/manabuyasuda/equip/tar.gz/refs/heads/v2","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238825795,"owners_count":19537129,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aigis","ejs","sass"],"created_at":"2024-09-24T14:05:25.123Z","updated_at":"2025-10-29T13:30:17.209Z","avatar_url":"https://github.com/manabuyasuda.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# equip - Make efficient site\n静的サイトを効率良く作るためのテンプレートです。以下のような特徴があります。\n\n* [EJS](http://ejs.co/)でヘッダーなどの共通部分のテンプレート化、JSONを利用したデータの管理\n* [FLOCSS](https://github.com/hiloki/flocss)をベースにしたSassのディレクトリ、レイアウト用コンポーネント、メディアクエリなどの@mixin\n* CSSや画像などのminifyと圧縮\n* アイコンフォントと専用のscssファイルの生成\n* Browsersyncを利用したライブリロード\n* [Hologram](http://trulia.github.io/hologram/)を利用したスタイルガイドの生成\n\nコーディングルールは以下のリンクをベースにします。\n\n* [CSSコーディングルール](https://github.com/manabuyasuda/styleguide/blob/master/css-coding-rule.md)\n* [画像の命名規則](https://github.com/manabuyasuda/styleguide/blob/master/image-naming-rule.md)\n\n## 始め方とGulpタスク\nnpmでパッケージをインストールします。\n\n```bash\nnpm install\n```\n\n開発に使用するGulpタスクは2つあります。\n\n```bash\ngulp\n```\n\n```bash\ngulp release\n```\n\n1. `gulp`（EJSとSassのコンパイル、jsの結合や画像の出力、アイコンフォントの生成、browser-syncによるライブリロード）\n1. `gulp release`（`gulp`タスクに画像とCSSの圧縮を追加。）\n\nいずれも`clean`タスクでreleaseディレクトリがあればいったん削除されます。\n\n## EJS\ndevelop/index.ejsがトップページになります。develop/_partialsディレクトリ内にグローバルに使用するテンプレートを保存します。\n\n新規案件でルートディレクトリに制作していくことを想定していますが、そうではない場合でも使えるように基本的に相対パスで記述します。ただし、グローバルナビゲーションで使い回しができるようにすると複雑になってしまうため、必要最低限であればルート相対パスで記述することもできます。\n\n### site.json\n\ndevelop/assets/data/site.jsonにサイト共通の値が指定されています。サイトの名前やOGPの指定などがありますので、最初に確認をして、変更してください。site.jsonの値は`site.name`のように呼び出すことができます。\n\n| 変数名                \t| 説明                                                                                                                                                                                                                                                                                                                                                                         \t|\n|-----------------------\t|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\t|\n| `site.name`           \t| サイトの名前を記述します。（`title`要素に使用されます）                                                                                                                                                                                                                                                                                                                      \t|\n| `site.description`    \t| サイトの簡単な説明を記述します。（`meta`要素内の`name`属性に使用されます）                                                                                                                                                                                                                                                                                                   \t|\n| `site.keywords`       \t| サイトのキーワードを記述します。（`meta`要素内の`name`属性に使用されます）                                                                                                                                                                                                                                                                                                   \t|\n| `site.author`         \t| その文書の作者名（そのサイトの運営者・運営社）を記述します。※省略可能（`meta`要素内の`name`属性に使用されます）                                                                                                                                                                                                                                                              \t|\n| `site.rootUrl`        \t| そのサイトの絶対パス（`http`で始まりドメイン名+`/`で終わる）を記述します。（OGPの`og:url`に使用されます）                                                                                                                                                                                                                                                                    \t|\n| `site.css`            \t| assetsディレクトリで読み込むCSSファイルの拡張子を記述します。`gulp release`タスクを実行すると、minify（圧縮）したCSSファイルが生成されます。名前は`~.min.css`になります、minifyしたCSSファイルを読み込む場合は`.min.css`と記述します。                                                                                                                                       \t|\n| `site.ogpImage`       \t| シェアされたときのサムネイル画像を絶対パスで記述します。（OGPの`og:image`で使用されます）                                                                                                                                                                                                                                                                                    \t|\n| `site.facebookAdmins` \t| Facebook insightsのデータの閲覧権限を与える個人のFacebookアカウントID（カンマで区切ると複数人に権限を与えられる）を記述します。`site.facebookAppId`か`site.facebookAdmins`のどちらかを記述します。（OGPの`fb:admins`に使用されます）※省略可能 \t|\n| `site.facebookAppId`  \t| Facebook insightsのデータの閲覧権限を与えるアプリ（サイト）のIDを記述します。`site.facebookAdmins`か`site.facebookAppId`のどちらかを記述します。（OGPの`fb:app_id`に使用されます）※省略可能                                                                                                                                                                                  \t|\n| `site.twitterCard`    \t| [Twitterでツイートされたときのスタイル](https://dev.twitter.com/ja/cards/getting-started)を指定します。（OGPの`twitter:card`で使用されます）                                                                                                                                                                                                                                 \t|\n| `site.twitterSite`    \t| Twitterでツイートされたときに表示するTwitterアカウントを@をつけて記述します。※省略可能（OGPの`twitter:site`で使用されます）                                                                                                                                                                                                                                                  \t|\n| `site.favicon`        \t| ファビコンに使用する画像を絶対パスで記述します。[.ico形式に変換した16px×16pxと32px×32pxのマルチアイコン](http://liginc.co.jp/web/design/material/16853)にするのが良いようです。※省略可能（`shortcut icon`に使用されます）                                                                                                                                                    \t|\n| `site.appleIcon`      \t| iPhoneでホーム画面に追加したときに使用される画像（ホームアイコン）を絶対パスで記述します。iPhone 6 Plusで180px、iPhone 6と5で120pxが適合するサイズです。※省略可能（`apple-touch-icon`で使用されます）                                                                                                                                                                        \t|\n| `site.appTitle`       \t| ホームアイコンを保存するときのタイトルの初期値を記述します。※省略可能[日本語は6文字以内、英語は13文字以内にすると省略されないようです](https://hyper-text.org/archives/2012/09/iphone-5-ios-6-html5-developers.shtml)。（`apple-mobile-web-app-title`に使用されます）                                                                                                        \t|\n| `site.analyticsId`    \t| Google Analyticsの[トラッキングID](https://support.google.com/analytics/answer/1032385?hl=ja)を記述します。                                                                                                                                                                                                                                                                  \t|\n| `site.developDir`     \t| 開発用ディレクトリ名を記述します。ファイルのルートパスを取得するのに使用されます。例えばdevelop/page1が開発用のルートディレクトリになるのであれば`\"develop/page1/\"`と変更します。                                                                                                                                                                                            \t|\n\n```json\n{\n  \"name\": \"サイトのタイトル\",\n  \"description\": \"サイトの概要\",\n  \"keywords\": \"サイトのキーワード1, サイトのキーワード2\",\n  \"author\": \"\",\n  \"rootUrl\": \"http://example.com/\",\n  \"css\": \".css\",\n  \"ogpImage\": \"http://example.com/images/og-image.jpg\",\n  \"facebookAdmins\": \"\",\n  \"facebookAppId\": \"\",\n  \"twitterCard\": \"summary\",\n  \"twitterSite\": \"@\",\n  \"favicon\": \"\",\n  \"appleIcon\": \"\",\n  \"appTitle\": \"\",\n  \"analyticsId\": \"\",\n  \"developDir\": \"develop/\"\n}\n```\n\nまた、develop/assets/dataディレクトリにはsample.jsonファイルが入っています。記事内で記事一覧やニュースなどをループで、処理をしたい場合に使用します。\n\n```js\n[\n  {\n      \"title\": \"title1\",\n      \"description\": \"description1\"\n  },\n  {\n      \"title\": \"title2\",\n      \"description\": \"description2\"\n  }\n]\n```\n\njsonファイルを追加する場合はgulpfile.jsにも追加する必要があります。`develop.data`でdataディレクトリへのパスを取得できます。\n\n```js\n.pipe(ejs({\n　　site: JSON.parse(fs.readFileSync(develop.data + 'site.json')),\n　　sample: JSON.parse(fs.readFileSync(develop.data + 'sample.json')),\n　　sample2: JSON.parse(fs.readFileSync(develop.data + 'sample2.json'))\n},\n```\n\nejsファイルでは`forEach()`を使用してデータを取得し、ループを回します。\n\n```js\n\u003c% sample.forEach(function(data){ %\u003e\n  \u003carticle class=\"article\"\u003e\n    \u003ch2\u003e\u003c%= data.title %\u003e\u003c/h2\u003e\n    \u003cp\u003e\u003c%= data.description %\u003e\u003c/p\u003e\n  \u003c/article\u003e\n\u003c% }); %\u003e\n```\n\nこのように出力されます。\n\n```html\n\u003carticle class=\"article\"\u003e\n  \u003ch2\u003etitle1\u003c/h2\u003e\n  \u003cp\u003edescription1\u003c/p\u003e\n\u003c/article\u003e\n\n\u003carticle class=\"article\"\u003e\n  \u003ch2\u003etitle2\u003c/h2\u003e\n  \u003cp\u003edescription2\u003c/p\u003e\n\u003c/article\u003e\n```\n\n### index.ejs\n\nindex.ejsには変更が必要なものや変更ができるものについての変数が定義されているので、ページごとに変更することができます。変数はindex.ejsとインクルードしている_head.ejsや_footer.ejsなどで`page.title`のように呼び出すことができます。\n\n| 変数名             \t| 説明                                                                                                                                  \t|\n|--------------------\t|---------------------------------------------------------------------------------------------------------------------------------------\t|\n| `page.title`       \t| そのページの名前を記述します。空にするとサイトタイトルだけ、記述するとサイトタイトルと一緒に出力されます。                            \t|\n| `page.desctiption` \t| そのページの説明を記述します。                                                                                                        \t|\n| `page.keywords`    \t| そのページのキーワードを記述します。`\"ページのキーワード1, ページのキーワード2\"`のようにクウォーテーション内でカンマ区切りで指定します。                                                                                                  \t|\n| `page.bodyClass`   \t| `body`要素にclassを指定できます。                                                                                                     \t|\n| `page.singleCss`   \t| ページ専用のcssファイルを作成したい場合に指定します。`[\"../common/css/category.css\", \"css/single.css\"]`のように配列でパスを渡します。 \t|\n| `page.singleJs`   \t| ページ専用のjsファイルを作成したい場合に指定します。`[\"../common/js/category.js\", \"js/single.js\"]`のように配列でパスを渡します。 \t|\n| `page.ogpType`   \t| OGPで使用されていて、トップページはwebsite、それ以外の記事はarticleを指定します。 \t|\n| `page.ogpImage`   \t| OGPで使用されていて、サイト共通であれば`site.ogpImage`を指定、個別に設定したい場合は`'http://example.com/images/og-image.jpg'`のように絶対パスで指定します。 \t|\n| `page.absolutePath`   \t| ファイルごとの`/`を含まないルートパスを格納しています。metaタグの絶対パスで使用されています。 \t|\n| `page.relativePath`   \t| ファイルごとの相対パスを格納しています。 \t|\n\n\n```js\n\u003c%\nvar absolutePath = filename.split(site.developDir)[filename.split(site.developDir).length -1].replace('.ejs','.html');\nvar relativePath = '../'.repeat([absolutePath.split('/').length -1]);\nvar page = {\n  title: \"\",\n  description: site.description,\n  keywords: \"\",\n  bodyClass: \"\",\n  singleCss: [],\n  singleJs: [],\n  ogpType: \"website\",\n  ogpImage: site.ogpImage,\n  absolutePath: absolutePath,\n  relativePath: relativePath\n};\n-%\u003e\n\u003c%- include(page.relativePath + '_partials/_head', {page: page, modifier: ''}); %\u003e\n\u003c%- include(page.relativePath + '_partials/_header', {page: page, modifier: ''}); %\u003e\n    \u003carticle\u003econtents\u003c/article\u003e\n\n\u003c%- include(page.relativePath + '_partials/_footer', {page: page, modifier: ''}); %\u003e\n```\n\n`include()`の第一引数はすべてのindex.ejs共通です。第二引数の1つ目の`page: page,`は各index.ejsの変数（`page`）をインクルードするファイルに渡しています。2つ目の`modifier: ''`はインクルードするファイルにclass属性を付け加えたい場合に指定します。例えば_header.ejsのインクルードで`modifier: ' header--fixed'`と渡した場合（スペースが入っていることに注意）、以下のように出力されます。\n\n```html\n\u003cheader class=\"header header--fixed\"\u003e\n```\n\nルートディレクトリのindex.html以外にファイルを作成したり場合は_sample.ejsをコピーして使いまわします。sample.ejsのようにアンダースコアを外すとHTMLとして出力されるようになります。\n\n下層ページのejsファイルはdevelop/page1ディレクトリをコピーして使いまわします。変数は下記のように変更して使います。\n\n```js\n\u003c%\nvar absolutePath = filename.split(site.developDir)[filename.split(site.developDir).length -1].replace('.ejs','.html');\nvar relativePath = '../'.repeat([absolutePath.split('/').length -1]);\nvar page = {\n  title: \"ページのタイトル\",\n  description: \"ページの概要\",\n  keywords: \"\",\n  bodyClass: \"\",\n  singleCss: [],\n  singleJs: [],\n  ogpType: \"article\",\n  ogpImage: site.ogpImage,\n  absolutePath: absolutePath,\n  relativePath: relativePath\n};\n-%\u003e\n\u003c%- include(page.relativePath + '_partials/_head', {page: page, modifier: ''}); %\u003e\n\u003c%- include(page.relativePath + '_partials/_header', {page: page, modifier: ''}); %\u003e\n\u003c%- include('_partials/_breadcrumb', {page: page, pageTitle: page.title, modifier: ''}); %\u003e\n    \u003carticle\u003econtents\u003c/article\u003e\n\n\u003c%- include(page.relativePath + '_partials/_footer', {page: page, modifier: ''}); %\u003e\n```\n\nルーディレクトリのindex.ejsファイル以外はパンくずリストをインクルードします。デフォルトでは`pageTitle: page.title`のようにファイルのタイトルがパンくずリストのタイトルになるようになっています。\n\n変更する場合は`pageTitle: '任意のタイトル'`のようにします。\n\n### _head.ejs\n\ndevelop/_partials/_head.ejsには共通で使用するメタタグなどが定義されています。基本的に変更する必要はなく、site.jsonやindex.ejsの設定によって要素を削除したりしています。\n\n```js\n\u003c% if (typeof modifier === undefined) { var modifier = ''; } -%\u003e\n\u003c!DOCTYPE html\u003e\n\u003chtml lang=\"ja\"\u003e\n  \u003chead prefix=\"og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# \u003c%= page.ogpType %\u003e: http://ogp.me/ns/\u003c%= page.ogpType %\u003e#\"\u003e\n    \u003cmeta charset=\"UTF-8\"\u003e\n    \u003cmeta http-equiv=\"X-UA-Compatible\" content=\"IE=edge\"\u003e\n    \u003cmeta name=\"viewport\" content=\"width=device-width,initial-scale=1.0\"\u003e\n    \u003c% if(page.title) { %\u003e\u003ctitle\u003e\u003c%= page.title %\u003e | \u003c%= site.name %\u003e\u003c/title\u003e\u003c% } else { %\u003e\u003ctitle\u003e\u003c%= site.name %\u003e\u003c/title\u003e\u003c% } %\u003e\n    \u003cmeta name=\"description\" content=\"\u003c%= page.description %\u003e\"\u003e\u003c% if(page.keywords) { %\u003e\n    \u003cmeta name=\"keywords\" content=\"\u003c%= page.keywords %\u003e\"\u003e\u003c% } %\u003e\u003c% if(site.author) { %\u003e\n    \u003cmeta name=\"author\" content=\"\u003c%= site.author %\u003e\"\u003e\u003c% } %\u003e\n\n    \u003clink rel=\"stylesheet\" href=\"\u003c%= page.relativePath %\u003eassets/css/common\u003c%= site.css %\u003e\"\u003e\u003c% if(page.singleCss) { %\u003e\u003c% page.singleCss.forEach(function(data) { %\u003e\n    \u003clink rel=\"stylesheet\" href=\"\u003c%= data %\u003e\"\u003e\u003c% }); %\u003e\u003c% } %\u003e\n\n    \u003cmeta name=\"format-detection\" content=\"telephone=no\"\u003e\u003c% if(site.favicon) { %\u003e\n    \u003clink rel=\"shortcut icon\" href=\"\u003c%= site.favicon %\u003e\"\u003e\u003c% } %\u003e\u003c% if(site.appleIcon) { %\u003e\n    \u003clink rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"\u003c%= site.appleIcon %\u003e\"\u003e\u003c% } %\u003e\u003c% if(site.appTitle) { %\u003e\n    \u003cmeta name=\"apple-mobile-web-app-title\" content=\"\u003c%= site.appTitle %\u003e\"\u003e\u003c% } %\u003e\n\n    \u003c!-- OGP --\u003e\n    \u003cmeta property=\"og:title\" content=\"\u003c% if(page.title) { %\u003e\u003c%= page.title %\u003e | \u003c%= site.name %\u003e\u003c% } else { %\u003e\u003c%= site.name %\u003e\u003c% } %\u003e\"\u003e\n    \u003cmeta property=\"og:type\" content=\"\u003c%= page.ogpType %\u003e\"\u003e\n    \u003cmeta property=\"og:image\" content=\"\u003c%= page.ogpImage %\u003e\"\u003e\n    \u003cmeta property=\"og:url\" content=\"\u003c%= site.rootUrl %\u003e\u003c%= page.absolutePath %\u003e\"\u003e\n    \u003cmeta property=\"og:description\" content=\"\u003c%= page.description %\u003e\"\u003e\n    \u003cmeta property=\"og:site_name\" content=\"\u003c%= site.name %\u003e\"\u003e\n    \u003cmeta property=\"og:locale\" content=\"ja\"\u003e\n    \u003c% if(site.facebookAppId) { %\u003e\u003cmeta property=\"fb:app_id\" content=\"\u003c%= site.facebookAppId %\u003e\"\u003e\u003c% } else if(site.facebookAdmins) { %\u003e\u003cmeta property=\"fb:admins\" content=\"\u003c%= site.facebookAdmins -%\u003e\"\u003e\u003c% } %\u003e\n    \u003cmeta name=\"twitter:card\" content=\"\u003c%= site.twitterCard %\u003e\"\u003e\u003c% if(site.twitterSite) { %\u003e\n    \u003cmeta name=\"twitter:site\" content=\"\u003c%= site.twitterSite %\u003e\"\u003e\u003c% } %\u003e\n    \u003c!-- / OGP --\u003e\n\n  \u003c/head\u003e\n  \u003c% if(page.bodyClass) { %\u003e\u003cbody class=\"\u003c%= page.bodyClass %\u003e\u003c%= modifier %\u003e\"\u003e\u003c% } else { %\u003e\u003cbody\u003e\u003c% } %\u003e\n```\n\n### _header.ejs\n\nvedelop/_partials/_header.ejsには共通で使用するメインナビゲーションが定義されています。グローバルナビゲーションは条件分岐が多く複雑になってしまうため、ルート相対パスで指定をします。\n\n\n```js\n\u003c% if (typeof modifier === undefined) { var modifier = ''; } -%\u003e\n    \u003cheader class=\"header\u003c%= modifier %\u003e\"\u003e\n      \u003ch1\u003e\u003ca href=\"/\"\u003e\u003c%= site.name %\u003e\u003c/a\u003e\u003c/h1\u003e\n\n      \u003cnav\u003e\n        \u003cul class=\"p-global-nav\"\u003e\n          \u003cli class=\"p-global-nav__item\"\u003e\u003ca href=\"/\" class=\"p-global-nav__link\"\u003ehome\u003c/a\u003e\u003c/li\u003e\n          \u003cli class=\"p-global-nav__item\"\u003e\u003ca href=\"/page1\" class=\"p-global-nav__link\"\u003epage1\u003c/a\u003e\u003c/li\u003e\n          \u003cli class=\"p-global-nav__item\"\u003e\u003ca href=\"/page2\" class=\"p-global-nav__link\"\u003epage2\u003c/a\u003e\u003c/li\u003e\n          \u003cli class=\"p-global-nav__item\"\u003e\u003ca href=\"/page3\" class=\"p-global-nav__link\"\u003epage3\u003c/a\u003e\u003c/li\u003e\n        \u003c/ul\u003e\n      \u003c/nav\u003e\n    \u003c/header\u003e\n```\n\n### _footer.ejs\n\ndevelop/_partials/_footer.ejsには共通で使用するフッターとスクリプトが定義されています。Google Analyticsを使用しない場合はエラーになってしまうので削除してください。\n\n```js\n\u003c% if (typeof modifier === undefined) { var modifier = ''; } -%\u003e\n    \u003cfooter class=\"footer\u003c%= modifier %\u003e\"\u003e\n      \u003cp\u003e\u003csmall\u003e© \u003c%= site.name %\u003e All Rights Reserved.\u003c/small\u003e\u003c/p\u003e\n    \u003c/footer\u003e\n\n    \u003c!-- JavaScript --\u003e\n    \u003cscript src=\"//ajax.googleapis.com/ajax/libs/jquery/2.2.0/jquery.min.js\"\u003e\u003c/script\u003e\n    \u003cscript\u003ewindow.jQuery || document.write('\u003cscript src=\"\u003c%= page.relativePath %\u003eassets/js/jquery-2.2.0.min.js\"\u003e\u003c\\/script\u003e')\u003c/script\u003e\n    \u003cscript src=\"\u003c%= page.relativePath %\u003eassets/js/bundle/bundle.js\"\u003e\u003c/script\u003e\n    \u003cscript src=\"\u003c%= page.relativePath %\u003eassets/js/common.js\"\u003e\u003c/script\u003e\u003c% if(page.singleJs) { %\u003e\u003c% page.singleJs.forEach(function(data) { %\u003e\n    \u003cscript src=\"\u003c%= data %\u003e\"\u003e\u003c/script\u003e\u003c% }); %\u003e\u003c% } %\u003e\n    \u003c!-- / JavaScript --\u003e\n\n    \u003c!-- Google Analytics --\u003e\n    \u003cscript\u003e\n      (function(i,s,o,g,r,a,m){i[\"GoogleAnalyticsObject\"]=r;i[r]=i[r]||function(){\n      (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),\n      m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)\n      })(window,document,\"script\",\"//www.google-analytics.com/analytics.js\",\"ga\");\n      ga(\"create\", \"\u003c%= site.analyticsId %\u003e\", \"auto\");\n      ga(\"require\", \"displayfeatures\");\n      ga(\"send\", \"pageview\");\n    \u003c/script\u003e\n    \u003c!-- / Google Analytics --\u003e\n  \u003c/body\u003e\n\u003c/html\u003e\n```\n\n### _breadcrumb.ejs\n\n_partials/_breadcrumb.ejsには各ディレクトリ共通で使用するパンくずリストが定義されています。\n\n```js\n\u003c% if (typeof pageTitle === undefined) { var pageTitle = ''; } -%\u003e\n\u003c% if (typeof modifier === undefined) { var modifier = ''; } -%\u003e\n    \u003col class=\"p-breadcrumb\u003c%= modifier %\u003e\"\u003e\n      \u003cli class=\"p-breadcrumb__item\"\u003e\u003ca href=\"../\" class=\"p-breadcrumb__link\"\u003eHome\u003c/a\u003e\u003c/li\u003e\u003c% if(pageTitle) { %\u003e\n      \u003cli class=\"p-breadcrumb__item\"\u003e\u003c%= pageTitle %\u003e\u003c/li\u003e\u003c% } %\u003e\n    \u003c/ol\u003e\n```\n\n_header.ejsや_footer.ejsと同じようにindex.ejsからmodifierの指定ができます。\n\n```js\n\u003c%- include('_partials/_breadcrumb', {page: page, pageTitle: page.title, modifier: ''}); %\u003e\n```\n\n`/page/index.ejs`でインクルードするファイルは`/_partials/_breadcrumb`となります。\n\n## assets\ndevelopディレクトリ直下は基本的にEJSのために使用します。それ以外のファイルはdevelop/assetsディレクトリで管理をしていきます。ページ専用のCSSや画像フォルダはassetsディレクトリに置かなくても大丈夫です。\n\n### image\nimageディレクトリは空の状態です。Gulpタスクを実行してもフォルダも生成されないので、仮の画像やOGP画像などを入れてからタスクを実行します。developディレクトリの階層構造を保ったままreleaseディレクトリに出力されます。\n\n### css\ncssディレクトリは[FLOCSS](https://github.com/hiloki/flocss)をベースにSassで構成しています。\n\n1. Foundation\n 1. function\n 1. variable\n 1. mixin\n 1. vendor（Normalize.css）\n 1. base（プロジェクトにおける、基本的なベーススタイル）\n1. Layout（ヘッダーやフッターのような、ページを構成するコンテナブロック）\n1. Object（プロジェクトにおけるビジュアルパターン）\n 1. component（多くのプロジェクトで横断的に再利用のできるような、小さな単位のモジュール）\n 1. project（プロジェクト固有のパターンで、コンテンツを構成する要素）\n 1. scope（ページ単位でスタイルを指定する）\n 1. utility（いわゆる汎用クラスで、ほとんどの場合は単一のスタイル）\n\nレイヤーを追加する場合は[CSS Styleguide](https://github.com/manabuyasuda/styleguide/blob/master/css-styleguide.md#flocss)を参照してください。\n\nobjectレイヤーのcomponentとprojectレイヤーにはグリッドやボタンなどの汎用的に使用できるスタイルがあらかじめ定義されています。\n\nfoundation/mixinレイヤーには汎用的に使えるいくつかのmixinが定義されています。グローバル変数を使っているものもあるので、foundation/variableレイヤーも確認してください。\n\n変数と関数はすべて`_`からはじまります。名前の区切りは`-`です。\n\n```scss\n// 変数\n$_max-width\n\n// function\n_z-index()\n\n// mixin\n_mq-up()\n```\n\n\nブレイクポイントはMapタイプの変数で定義されています。\n\n```scss\n// min-width\n$_breakpoint-up: (\n  'sm': 'screen and (min-width: 400px)',\n  'md': 'screen and (min-width: 768px)',\n  'lg': 'screen and (min-width: 1000px)',\n  'xl': 'screen and (min-width: 1200px)',\n) !default;\n\n// max-width\n$_breakpoint-down: (\n  'sm': 'screen and (max-width: 399px)',\n  'md': 'screen and (max-width: 767px)',\n  'lg': 'screen and (max-width: 999px)',\n  'xl': 'screen and (max-width: 1199px)',\n) !default;\n```\n\n呼び出すときは`_mq-up()`で`min-width`が、`_mq-down()`で`max-width`が出力されます。mixinの引数に変数のキーを渡すと、それに対応した値が返ります。\n\n```scss\n.foo {\n  color: red;\n  @include _mq-up(sm) {\n    color: blue;\n  }\n}\n\n// @example css - CSS output\n.foo {\n  color: red;\n}\n@media screen and (min-width: 400px) {\n  .foo {\n    color: blue;\n  }\n}\n```\n\nその他にもclearfixを呼び出す`_clearfix()`やレスポンシブに対応したクラスを生成する`_responsive()`、マウスオーバーなどのイベントを一括で指定する`_on-event`などがあります。\n\nSassはCSSにコンパイルされるときに「autoprefixer」でベンダープレフィックスの自動付与、「csscomb」で整形とプロパティの並び替えが実行されます。また、CSSファイルと同じディレクトリにsourcemapsが出力されます。\n\ndevelop/assets/css/_single.scssはFoundationレイヤーにあるfunction、Variable、Mixinレイヤーをインポートしています。HTML専用のCSSファイルには以下のように記述して_single.scssをインポートします。\n\n```scss\n/* =============================================================================\n   #Index\n   ========================================================================== */\n// プロジェクト共通のグローバル変数と関数をインポートします。\n@import \"../assets/css/_single\";\n```\n\nfunction、Variable、Mixinレイヤーにファイルを追加したときには_single.scssにも追記をしてください。\n\n### js\nJavaScriptはassets/js/bundleディレクトリにjQueryプラグインやライブラリなどのファイルを保存します。連結されて`bundle.js`として出力されます。minifyはされません。それ以外のjsファイルはそのままの階層で出力されます。\n\n* jQueryはCDNとフォールバックの読み込みをしています。2.0系を読み込んでいるのでIE9以降からの対応になります。\n* jQueryプラグインなどはassets/js/bundleディレクトリに保存してください。ディレクトリ内のファイルを自動で連結して`bundle.js`として出力されます。\n* 自作のスクリプトやjQueryプラグインなどのトリガーはassets/js/common.js（名前は変更可能）に記述してください。\n\n\n### アイコンフォント\ndevelop/assets/iconディレクトリにSVGファイルを保存するとアイコンフォントが自動で生成されます。アイコンフォント専用のscssファイルも同時に生成されます。\n\n* develop/assets/iconにSVGファイルを保存\n* develop/assets/fontにフォントファイルを出力\n* develop/assets/css/object/projectにscssファイルを生成\n* developディレクトリと同じ階層でrelaseディレクトリにフォントファイルがコピー\n\nscssファイルのテンプレートはdevelop/assets/icon/templateに保存されています。適宜変更してください。  \nスタイルの追加はdevelop/assets/css/object/project/_icon-extend.scssにしていきます。\n\n使用しない場合はgulp.fileからタスクを削除してください。\n\n## スタイルガイドの生成\nスタイルガイドの生成は[Hologram](http://trulia.github.io/hologram/)を使用しています。\n\nBundlerのインストール。\n\n```bash\ngem install bundler\n```\n\nHologramのインストール。\n\n```bash\nbundle install\n```\n\nスタイルガイドの生成。\n\n```bash\ngulp styleguide\n```\n\n詳しくはhologram/README.mdを参照してください。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanabuyasuda%2Fequip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanabuyasuda%2Fequip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanabuyasuda%2Fequip/lists"}