導入
ソースコードを取得して、自分のものにする
Foundation は公開され、自分で進められます。リポジトリを取得し、実行し、身元とコンテンツを差し替え、検証し、自分のアカウントへ公開します。公開リポジトリが正規の技術情報源であり、このページはそこへ至る最短の正直な道筋です。
- ソフトウェアを使うために Foundation のアカウント作成やライセンス料は不要です。ホスティングとドメインはあなた自身の費用です。
- ここで参照する各ドキュメントは公開リポジトリにあり、説明対象のコードと同じ版で管理されています。
- このページの内容を鵜呑みにする必要はありません。リポジトリは 1 クリック先にあります。
3 つの正規の導入方法
Foundation は Provelopment を求めず、一人で作業することも求めません。導入者が実際に取る 3 つの方法で、どれも同じように有効です。
自分で使う
技術的な余力のある導入者向け:リポジトリを取得し、ローカルで実行し、身元を設定し、コンテンツを書き、検証して公開します。必要なものはすべて公開リポジトリにあり、Provelopment に依存するものはありません。
自社の開発者や代理店に任せる
導入で変更するものはプラットフォームのコードではなく設定、コンテンツ、アセットにあるため、Foundation を見たことがない開発者でも対応できます。
Provelopment に頼む
Provelopment は導入支援、技術支援、サポート、運用サービスを提供できます。それは基盤とは別で、完全に任意です。
どれも推奨される方法ではありません。到達するサイトは同じで、どの方法でもソースはあなたの手元に残ります。支援を受けるか受けないかはサービスの判断であり、いつでも選び直せます。
リポジトリから動くサイトまでの道筋
導入の手順をすべて順番に示します。ここには再掲しません。各手順は詳細を持つドキュメントを示し、このサイトがリポジトリの指示からずれる二つ目の写しにならないようにしています。
1
動くサイトを見る
まずデモを見てください。1 つをこのサイトと比較し、身元、コンテンツ、ナビゲーション、機能構成のどこが変わったかを書き留めます。そこで見たものはすべて自分のコピーで設定できます。
2
GitHub でプロジェクトを見る
プロジェクトが何で、何を含み、リポジトリがどう構成されているかを読み、時間をかける前にアーキテクチャのドキュメントに目を通します。
3
ソースを取得する
公開リポジトリを clone または fork します。最初の 1 分から自分の管理下のコピーを持てます。登録も申請も待ち時間もありません。
4
ローカルで実行する
依存をインストールして開発サーバーを起動すれば、初期サイトがすぐに表示されます。埋めるべき空のフォルダーではなく、動くサイトです。
5
身元とサイト設定を構成する
サイト設定の仮の身元(URL、名称、スローガン、説明)を差し替え、必要な任意機能を決めます。各機能には明示的な無効状態があります。
6
コンテンツとアセットを書く
ページとビジネスコンテンツは自分のサイトディレクトリに Markdown と設定として置かれ、ビジュアルは役割ごとに仮のグラフィックを置き換えます。
7
必要に応じて外部サービスを接続する
有効にした機能だけが接続先を必要とします。問い合わせのエンドポイント、予約先、地図上の所在地、分析事業者などです。認証情報はデプロイ環境にあり、設定ファイルには入れません。
8
公開前に検証する
リポジトリの検証ゲートを実行します。設定はビルド時に検査され、有効にしたまま未完成の機能は、動いているふりをせず大きな音で失敗します。
9
自分のアカウントへ公開する
管理するホスティングへ公開し、自分のドメインを向けます。デプロイの手引きは、最初の公開、継続的インテグレーションの保護、独自ドメインの手順、公開後の確認を扱っています。
10
維持と更新
上流の改善を意識的に取り込めるよう、コピーをリポジトリにつないでおきます。設定、コンテンツ、辞書、アセットは更新を越えて残り、プラットフォームのコードは置き換わります。
実際の導入がたどる順序で 10 の手順を示しました。正確なコマンドと設定はリポジトリにあります。そこではレビューされ、版管理され、コードの変化に合わせて正しく保たれます。
始める前に必要なもの
Foundation は実際のコードベースであり、ホスティング型のサイトビルダーではないため、導入には正直な前提があります。いずれも小規模で、あなたが選んでいない事業者を必要としません。
- モダンなウェブプロジェクトへの慣れ:設定ファイル 1 つ、Markdown ファイル、いくつかのターミナルコマンド。
- 管理するホスティングアカウントと、独自のアドレスが必要ならドメイン。デプロイの手引きは Vercel を最初から最後まで扱っています。
- 仮の内容を置き換える、自社の身元、コンテンツ、画像。
- 連携を有効にした箇所に限り、外部サービスのアカウント。
それ以外は必須ではありません。Provelopment のアカウント、有料プラン、特定のホスティング事業者、特定の開発者を求めることはありません。
あなたのサイトはあなたのもの
Foundation はソフトウェアで、サイトはあなたのものです。Provelopment と関わり続けるかどうかはサービスの判断で、技術的な拘束ではありません。
ソースはあなたが保持します
リポジトリのコピーがあなたのデプロイです。有効化の手順も、ライセンスサーバーも、稼働中のサイトが依存するアカウントもありません。
公開はあなたのものです
自分のホスティングアカウントと自分のドメインへ公開し、デプロイ手順は私たちではなくあなたのアカウントを前提にしています。
開発者の選択はあなたのものです
設定、コンテンツ、アセットはあなたが変更できるため、作業はどの有能な開発者にも引き継げます。属人的な知識や、立ち上げた人への依存はありません。
事業者の選択はあなたのものです
問い合わせの受け取り、予約、地図の経路、分析はサイト単位で設定するため、用意された組み合わせを引き継ぐのではなく自分で選べます。
後から加える作業も分離できます
あなたや代理店が Foundation の上に作るものは、自分の設定、コンテンツ、アセットにあるため、それを捨てずに上流の改善を取り込めます。
Foundation は Apache License 2.0 のオープンソースです。ライセンス条件を守る限り、プロジェクト自身のコードとドキュメントを、自社の所有するウェブサイト内も含めて使用、変更、配布、商用利用できます。具体的には、ライセンスの写しと帰属表示を保持し、変更を偽って示さず、ソフトウェアが無保証で提供されることを受け入れる必要があります。これは著作権ライセンスであり、Provelopment の名称、ロゴ、ブランドの権利は含まれません。同梱の第三者素材はそれぞれのライセンスと帰属を持ちます。この段落は要約であり、ライセンス本文が優先します。
プロジェクトに同梱される第三者の商標とアイコンは各権利者に帰属し、Foundation のライセンスではなく各社の条件に従います。
詳細を持つドキュメント
Foundation のドキュメントはコードと一緒に配布されるため、コードから離れることがありません。以下はいずれもその分野の権威であり、このページが繰り返す必要はありません。
README
プロジェクトの内容、始め方、リポジトリの構成、実際の検証コマンド。
CUSTOMIZING.md
下流利用者のための手引きと設定の完全なリファレンス。あなたのものとプラットフォームのものを分ける表を含みます。
ARCHITECTURE.md
アーキテクチャのスタイル、境界、依存の向き、連携のパターン。Foundation を初めて見る人から生産的になるまでの最短経路です。
BRAND_ASSETS.md
ブランドアセットの差し替え契約:置き換え可能なすべてのビジュアルの役割と、置き換える順序。
DEPLOYMENT.md
リリース手順書:最初の公開、継続的インテグレーションの保護、独自ドメイン、公開後の確認リスト。
instruction-manuals/
手順:導入、カスタマイズ、コンテンツ、ブランド、検証、デプロイ、更新、トラブルシューティング。
LICENSE
使用、変更、再配布を規定する Apache License 2.0 の本文。
このページとリポジトリが食い違う場合は、リポジトリが正しいです。このページは導入の形を説明し、リポジトリがそれを実行します。
支援が必要なら利用できます
Provelopment は導入支援、技術支援、サポート、運用サービスを提供できます。それは基盤とは別で、完全に任意です。
- Foundation を導入し、自分で公開し、Provelopment に一度も連絡しないことは、完全に成功した結果です。
- ソフトウェアのどの部分も Provelopment に依存せず、ドキュメントやコードが有料プランの背後に置かれることもありません。
- 支援はプロジェクトとは別に取り決めます。このサイトは販売窓口やサポート窓口ではありません。
順序が重要です。まず Foundation をそれ自身の条件で、支援は必要ならその後で。
今の立場から始める
デモを開いて完成した Foundation サイトを見て、リポジトリを読んで実際に何を扱うかを確認し、作る準備ができたら手引きを使ってください。