デザイナーが1人でGatsbyを使ってサイトを作ったよ #1 #React

この記事について

内容を一言でまとめると

フロントの知識があまりないデザイナーが、サイトを公開するに至った道のり。
ちなみに続きの記事も書きました。

こんな人が読んでくれたら嬉しい

1からコードを書くことが苦手なデザイナー
自分のサイトを作って公開したことがないデザイナー

作ったサイト
使っている技術、サービスなど
GatsbyJSに決めるまでの経緯
GatsbyJSに決めてからやったこと
ドメイン取得
小さなプロトタイプ作り
コンテンツ作成
スタイリング
Netlifyへの移行
スターター選定、プラグイン導入など
まとめ

作ったサイト

自分のポートフォリオサイトを作りました。
まだまだコンテンツは少ないのですが、これで完成ではありません。
これからの育ち方も含めて1つの作品にするつもりです。

GitHubはコチラ

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

Figma（ビジュアルデータ作成）
GatsbyJS（静的サイトジェネレーター）
Emotion（CSS in JSのライブラリ）
Netlify（ホスティングサービス）
zeroheight（デザインガイドライン作成）

GatsbyJSに決めるまでの経緯

会社の業務でReactを使うことが増えていたので、
「練習を兼ねてReactで作ろうかな〜」くらいの軽い気持ちでいました。

しかし、作ろうとしていたのは個人のポートフォリオサイト。

静的なコンテンツ
DOM操作はほとんどしない（はず）

わざわざReactで作る意味があるのかなあと少し悩みました。

そんな中、TwitterでGatsbyJS関連の記事が流れてきて初めて認知。
「環境構築が簡単で表示も速いらしい、更新も楽そうだしこれを使ってみたいな」と決定。

GatsbyJSに決めてからやったこと

まずは公式のドキュメントを一通り読みました。

本当は日本語記事を見ながらやれば良いかと思っていましたが、全然見つかりません。
公式リファレンスをちゃんと読む練習も兼ねて挑戦。

クイックスタートの通りにコードを書いてみてイメージを掴みます。
Gatsby CLIをインストールしてサイトの雛形を作成、develop, build, serveと基礎の基礎だけを理解しました。
ちなみに

develop = 自分のPC上でサイトを立ち上げる、本番環境で人が見るコードとは違う
build = 静的なファイルに書き出し、ここで出来たものをアップロードすれば公開できる
serve = 本番環境と同じものを自分のローカル上で確認できる

というイメージです。
最初は正直これらの差もあまりわかっておらぬまま進めていましたがどうにかなりました。

その後はチュートリアルを全部やりました。
HomebrewやNode.jsの導入から教えてくれるので環境構築で詰まることは少ないのではないでしょうか……？
少なくとも今まで自分が見たことのあるチュートリアルの中ではかなり親切な方だと思います。

チュートリアルの全体は

環境構築
JSXの書き方
CSSの当て方
Componentのネストによるレイアウトの仕方
データの扱い方（GraphQL）
gatsby-source-filesystemの扱い方（Gatsbyがどうやって各種データを保持していて、いかに出力するのか？みたいなことが書いてあります）
MarkdownからHTMLへの変換の仕方
複数のページをMarkdownから出力するやり方
サイト公開の準備（SEO含む）

というものです。
（本当はこの後にThemeについてのチュートリアルともう少し突っ込んだチュートリアルがありますが、万人に必要なものではないと思います。楽しくなってきちゃった方だけで大丈夫かと。）

ドメイン取得

チュートリアルを終えた後の気持ちは
「全然理解してないけどとりあえず手を動かそう」
でした。

が、ここで問題が発生します。

自分のドメインを持っていないし、取得したこともありません。

記憶が曖昧ですが、たしか「ドメイン取得おすすめ」などと検索。
出てきた記事内でオススメされるがままにムームードメインで取得したはずです。

ドメイン取得は値段以外で何がどう違うのか未だに分かっておらず……。
詳しい方がいれば教えていただきたいです。

あとはこのタイミングでロリポップのレンサバも契約していました。
一瞬だけ使った後にNetlifyへ移行済。

ちなみに取得したのは.work。
初年度だけでなく2年目以降も割と安かったのと、
「デザイン以外のサイトコンテンツも作りたくなるかもしれないし、汎用的な方が良いよね！」
と捕らぬ狸の皮算用。

小さなプロトタイプ作り

歴史を遡ったところ、一番最初に公開したのはコレのようです。

ページ遷移、なし
コンテンツ、なし
ただ文字がアニメーションしているだけ。

たったこれだけのサイトでしたが

ドメインとレンサバを紐づけるのってどうやってやるんだ？
会社ではmergeすれば本番公開されるけど、今ってされてなくない？
WHOISってなんだよ？
よくわかんないけどポチポチしてたらhttpsになった、一体何が起こったのか？

などと分からないことだらけ。
結局Netlifyに移行したので必要なかった作業も多いのですが……色々調べる機会になりました。

自分でやってみたことでエンジニアの皆さんへの感謝がぶち上がり、一人で四苦八苦した価値がありました。
いつもありがとうございます。

コンテンツ作成

意味深なアニメーションだけのトップページから脱却すべく、下層ページを作成しました。

テキストだけローカルで書いて、あとはせっせとFigmaにコピペ。
（Figmaには日本語入力バグがあってFigma上でテキストを打つのはかなりしんどい）
デザインデータを作るのはいつもやっているように進めるのみ。

コンテンツ作成のポリシーなどはポートフォリオに記載していますので良ければそちらをご覧ください。

スタイリング

せっかくGatsbyというモダンなジェネレーターを使うのだからと、スタイリングも新しいものにチャレンジしてみました。

ボツになったものたち

初めのしばらくはstyled-componentsを使用。

機能的に悪い箇所はなかったのですが、なぜスタイル宣言時にタグを指定しなければならないのかが腑に落ちずあまり好きになれませんでした。

// 公式にあるコード
const Wrapper = styled.section`
  padding: 4em;
  background: papayawhip;
`;

sectionかarticleかdivかなど……タグの意味と見た目は分離されているべきではないでしょうか？

また、はじめに宣言したタグから変更することも出来るのですが

// 公式にあるコード
const Component = styled.div`
  color: red;
`;

render(
  <Component
    as="button"
    onClick={() => alert('It works!')}
  >
    Hello World!
  </Component>
)

どういうことかというと

スタイリングされたdivとしてComponentを宣言する
Componentの使用時に「このComponentをbutton扱いにする」という意味のpropを渡す

定義したスタイルは一緒なのに都度asを渡さなければならないのがイマイチです。
かといってタグ違い用に同じ見た目のComponentと複数作るのはもっとWET。

ファイルでComponentを分けているのにComponent内に見た目のためだけのローカルな（？）Componentが複数生まれるのもなんだかしっくり来ず……。

styled-jsxも試しましたが、こちらも似たような理由でやめてしまいました。
あとはJSX内に毎度毎度別のタグっぽく<style jsx>を入れないといけないのもなんだか……。

その他CSS ModulesやらJSSやらも検討しましたが採用には至らず。

今採用しているもの→Emotion

最終的にはEmotionに落ち着きました。
css PropのString Stylesを使ってスタイルを書いています。
Object StylesだとCSSTypeが使えるっぽいのですが、頭にすっと浮かぶプロパティはハイフン付きのものなので迷いつつString Stylesを選択。

実際のコードはこんな感じです。

Button.js

import React from 'react'
import { Link } from 'gatsby'
import hexToRgba from 'hex-rgba'

import { css } from '@emotion/core'
import Color from '../styles/Color'
import Size from '../styles/Size'
import Typography from '../styles/Typography'

const root = css`
  display: inline-block;
  color: ${Color.White};
  background-color: ${Color.Blue};
  ${Typography.Body};
  font-weight: 500;
  text-decoration: none;
  border-radius: ${Size(1)};
  box-shadow: 0 ${Size(0.5)} ${Size(2)} ${hexToRgba(Color.Black, 16)};
  padding: ${Size(2)} ${Size(3)};
`

export default ({ children, to }) => (
  <Link to={to} css={root}>
    {children}
  </Link>
)

ColorとかSizeとかTypographyは自分で作った定数や関数で、いちいち値を書かなくて良いようにしています。

Netlifyへの移行

ドメインをとったのがムームードメインで、当初は運営が同じGMOペパボさんで連携があるロリポップのサーバーを当初は借りていました。
しかし……ロリポップのマニュアルに載っていたのはFTPでファイルをアップロードするやり方。

はじめの内こそ

ローカルで開発
Gatsby buildでpublicディレクトリに書き出し
中身をまとめてアップロード

と律儀にやっていましたが……正直面倒くさい！
怠惰な性格には自信があるので、簡単に出来るやり方を模索していました。

調べているうちにNetlifyなら簡単に出来そうだったので使ってみることに。

初期設定の時期は良い感じのタイミングでやるべきことの指示が出るので
言われるがままやっていたら

GitHubでmasterにmergeしたら本番リリースされる設定
常時SSL化
Netlify DNSの準備

などが終わっていました。
あれ？こんなんで良いんでしょうか……書いててちょっと不安になってきました。

スターター選定、プラグイン導入など

若干時系列は前後しますが、Gatsbyで新規にサイトを作成するときは

gatsby new [SITE_DIRECTORY] [URL_OF_STARTER_GIT_REPO]

というコマンドを叩きます

自分はデフォルト設定になっているgatsby-starter-defaultから作りました。

スターターなのに若干CSSの指定が入り組んでいるような気がしますが……多分一番シンプルに始められます。
このスターターを使った時点で適用されているプラグインは

gatsby-plugin-react-helmet
gatsby-source-filesystem
gatsby-transformer-sharp
gatsby-plugin-sharp
gatsby-plugin-manifest

これで全部のはずです。
具体的に何がどう動くというよりはGatsbyの根幹を作っているプラグイン達だと思います。

動くものが出来てきたら徐々にプラグインを増やしていきました。
下記のものは2019年8月27日現在のリストなので多分まだ増えると思います。

gatsby-plugin-emotion
- 途中で説明したEmotionを使うために必要なプラグインです
gatsby-plugin-sitemap
- SEO用に入れました、サイトマップを出力してくれます
gatsby-plugin-netlify
- 機能は色々ありますが、301転送をしたいがために入れました

まとめ

多分フロントエンドエンジニアの方にコードレビューしてもらったらすごい数のご指摘をいただくと思うんですが、それでも動いています。

苦労しながらも一人で動くものを作れた経験は大きいと思っていて、引き続きこのサイトを使って新しい挑戦をしていくつもりです。

また、記事の冒頭に挙げた

1からコードを書くことが苦手なデザイナー
自分のサイトを作って公開したことがないデザイナー

こういった人たちに「自分も試しにやってみようかな」と思えるきっかけを提供できたら嬉しいです。

最後まで読んでいただいてありがとうございました。

デザイナーが1人でGatsbyを使ってサイトを作ったよ #1