Nuxt.jsとcontentfulとNetlifyで作るWebサイト
この記事は、TechTrain Advent Calendar 2019の15日目の記事です。
こんにちは、@kohey18 です
普段はBandという会社の代表しながら、様々なクライアント(医療系/EC系/CtoC系etc)の「開発支援」や「組織マネージメント支援」を行っています(たまに「デザイン支援」もする)
副業したい!業務委託先探している!みたいなエンジニアは連絡くれたらお茶でもしましょー!!
自分の会社のコーポレートサイトもまともに作っていないのに、
クライアントの コーポレートサイト
や サービスサイト(≒LP)
の設計/開発/デザイン/コーディング/運用に入る機会がたまたまあり、「あ、この構成いいかも」と思ったので、改めてこの機会にまとめようかなと
こんな人は参考になるかも?
- 今からサービスを紹介するページを作りたい!運用したい!改善サイクルを早く回したい!
- 自社のコーポレートサイト作らないといけない お問い合わせフォームも付けてねって言われたよ
- 9割静的なページ + 1割動的なページのサイトを作らないと!ホスティング先は?デプロイどうする?動的に差し込みたいデータどうやって取ってくる?みたいな人
あるあるな要件
- 「お問い合わせフォームつけてね、メールにも飛ばしたいし、Slackにも飛ばしたいよね」
- 「プレスリリース等のNews一覧ページ/詳細ページも作りたい」
- 「Newsページの詳細ページはブログ書くみたいなCMSほしい、あ、見出しも付けたい!画像もアップロードしたい!タグも付けたい」
- 「いや、、、とはいえ、WordPress導入はしたくない、、、、CMSも作りたくない、運用保守したくない、、!」
- 「エンジニアの手を使わずに反映できる仕組みがほしいよね」
僕はこうやって作った
それぞれの良さをざっとまとめますね
Nuxt.js
普段めちゃめちゃ React.js x TypeScript
でアプリケーション作るんですけど、こういう静的なテンプレートがほとんどのサイトは <template></template>
で書ける方がいいかなと思って、Nuxt.jsにしました
この辺通りに進めれば、ベースのプロジェクトはさくっとできるので、最高
ref: https://ja.nuxtjs.org/guide/installation
ディレクトリ構成は https://ja.nuxtjs.org/guide/directory-structure この辺を参考にしてほしいです
あるあるでいうとこんな感じの構成
pages
├── about.vue // /about ページ
├── index.vue // TOPページ
├── news
│ ├── _id.vue // News詳細ページ
│ └── index.vue // News一覧ページ
layouts
└── default.vue // Layout構成
components
├── Footer.vue
├── Header.vue
-
layouts/default.vue
(あっ、pugで書いています)
<template lang="pug">
.layouts
.layouts__header
HeaderComponent
.layouts__main
nuxt
.layouts__footer
FooterComponent
</template>
<script>
import HeaderComponent from "../components/Header.vue";
import FooterComponent from "../components/Footer.vue";
export default {
components: {
HeaderComponent,
FooterComponent
}
};
</script>
今のところ、マークアップできるぐらいのデザイナーが迷わずにcommitできているのを見ると、Nuxt.js選んで良かったかなーとか思ったりしました
contentful
Headless CMSと言われるもの。
なにができるかめちゃ簡単に説明すると「Newsを投稿するCMSが用意されていて、欲しい型でJSONが返ってくる」
contentfulでNewsページのモデル設計をする
あるあるな構成
この辺の構成は要件詰めながら、エンジニアがここまで作ってあげると良さそう
CMSどんな感じ?
タイトルを設定したり、記事内容を書いたり、、、!!
公開時間を設定したり、サムネイルの画像をアップロードしたり、Instagramから取ってきたりetc
そもそもcontentfulにどういうフォーマットあるの?
この辺までは自由に扱えます!!
Nuxt.js側でどうやってFetchしてくるの?
News一覧を取ってくるところだと、こんな感じで書いています!
contentfulのNewsデータをFetchしてくるところも、limitやorderのパラメーターがあるので柔軟にいけます!
<template lang="pug">
</template>
<script>
import { createClient } from "~/plugins/contentful.js"; // contentfulのplugin設定をする
const client = createClient();
export default {
components: {},
data() {
return {
currentPosts: []
};
},
asyncData({ params }) {
return client
.getEntries({
content_type: "news", // News一覧を
order: "-fields.publishedAt", // 最新順で
limit: 4 // 4件取ってくる
})
.then(entries => {
return {
currentPosts: entries.items
};
})
.catch(error => {});
},
methods: {
}
};
</script>
<style lang="stylus"></style>
動的にデータを入れてCMSもあって、API化させたい!みたいなときにcontentful使ってみるのはいかがでしょうか?
Netlify
(Netlifyってロゴは先頭小文字だし、サイト内は先頭大文字だし、正しい表記どっち?!?!?ってなりませんか、皆様)
なにができるかというと
- hosting
- build
- deploy
がベースで、
PullRequestがmasterにマージされれば、 build
-> deploy
まで走る仕組みとかはマジで改めて最高です
とはいえ、僕的には
-
deploy preview
- Pull Requestごとにプレビューリンクが発行されるからマージ前に皆がチェックできる
-
Netlify Form
-
<form>
を特に難しいことしなくてもメールに届くし、Slackにも届くし、各種webhookの対応できる
-
上記2つが「チームで開発する視点」だと非常に有効でした!!
deploy preview
(すでにマージされた事例で申し訳ないのですが)
ココ!ってなっているところをクリックすると、preview用のリンクが発行され、マージ前に皆で動作確認できた上でマージする運用がしやすくて、これもnetlifyにGitHubの設定の連携をするだけでうまく行ったのですごく良かったです
Netlify Form
一般的なformの構成に
<form>
<!-- 入力項目 -->
<input type="submit" />
</form>
これに
<form netlify>
<!-- 入力項目 -->
<input type="submit" />
</form>
netlify
を <form>
に入れるだけでform内のsubmit情報が全てNetlify側に吸い上げられる
Netlify側でformの入力項目が吸い上げられたら、あとはNetlify側でどこに飛ばすか(メールやSlack)を最後設定するだけで、
メールに飛んだり、Slackに飛んだりする
お問い合わせフォームをSlackとメールに飛ばす設定例
以下実用例コード(pugです)
form(
name="contact" // Netlify formのデータのグルーピングに命名必須
@submit="checkForm" // 送信前チェック
method="POST"
action="/contact/accepted" // 送信完了後にどこのページに飛ぶか
netlify // Netlify formを利用するにはこれを入れるだけ
)
チームで開発する上において
- 最初の仕組み(contentfulをFetchするところやNetlify form)だけ作ればエンジニアの手を借りずに(とはいえレビューとかはあるよ)、デザイナーが率先してサイトを更新 したり、 Pull Requestがマージされればそのまま本番反映される仕組み はエンジニア手離れできている and 改善サイクルが圧倒的に速いなと思っていてめちゃめちゃいいなと今のところチームで運用していても思う
最後に
色々開発/運用しているしているフェーズだが本構成でサイト作るのは良さそうだなという所感だったのでまとめてみました。
httpsの証明書あたりもNetlifyに寄せていたりしますが、本当は社内の証明書全てAWSのACMで管理しているのもあると、そちらに寄せたいなーとか思ったりなのですが、その辺の知見もまだない感じです!
nuxt.config.jsの設定周りの知見も少しずつ増えてきたので、手を動かしながらベストプラクティス探していこうと思います!
Author And Source
この問題について(Nuxt.jsとcontentfulとNetlifyで作るWebサイト), 我々は、より多くの情報をここで見つけました https://qiita.com/kohey18/items/e1da7076437268dd650f著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .