triumphmayflowerclub.com
ved Mark Smith's email address
triumphmayflowerclub.com 
Triumph Mayflower Clubは、英国の自動車メーカーのTriumphによる1950年代のクラシック車であるMayflowerの保存に特化した組織です。クラブ自体は1974年に結成され、2005年に最初のWorld Wide Webへの限定的な進出を行いました。その後、私（Andi、Project Mentawerer）は、両親がメンバーになったときにゼロから新しいWebサイトを作成するよう依頼されました。車とクラブについてもっと読むことに興味があるなら、ここをクリックしてください。
この新しいWebサイトは、ドキュメントのマークアップのためにVanilla HTML5、スタイリング用のCSS3、少量のJavaScript（ES6）のCSS3に書かれており、Jekyllを静的サイトジェネレーターとして使用してコードの重複を最小限に抑えるために構築されています。主要な「エバーグリーン」ブラウザ（IE ChromiumベースのMicrosoft Edge、Google Chrome、Mozilla Firefox、Apple SafariまたはOpera）、デスクトップまたはモバイルで問題なく実行するように設計されています。
制作サイトの現在のホスティング状況は、静的HTMLサイト（Yay、Niche Clubの予算制約）のホストにのみ本当に適しているため、それ以外のものをホストすることは実際には実用的ではありません。より複雑なクライアントサーバーソリューションを可能にするため。
Webサイトのさまざまなホストバージョンは、Canary Serverが自動化されたGitHubページである次の場所にあります。サイトベースの最新のmasterでは、ステージング領域は、新しい機能をテストしたい場合に手動で展開するライブWebサイトのサブドメインです。
ああ、それを楽しんでいるだけで、これが古いウェブサイトが比較のためにどのようになったかです！
GitHubリリースシステムは、バージョンのバージョン、タグ、パブリッシュリリースを増やすために使用され、Webサイトの現在のバージョンが何であるかの単一の真実のソースです。レポのファイルに明示的に保持されているバージョン番号はありません。
このコードベースはウェブサイトであるため、バックポートの修正にリリースブランチを維持する必要はありません。常に最新の変更があるライブサイトが1つしかないためです。
サイトの新しいバージョンがGitHubを介してリリースされると、Webサイトは実行時に特定のGithub APIエンドポイントを照会して、最新リリースのバージョン番号と公開日を取得し、各ページのフッターにエンドユーザーに表示されます。
SEMVERは、Webサイトのバージョン番号付けスキームとして、大まかにはあるが使用されています。メジャー、マイナー、パッチの部品は、コードベースの次のタイプの変更に従ってリリースのために衝突します。
これまでに公開された2つの主要なリリースがあります。これらは、主要な変更と次のメジャーアップデートのために現在進行中の機能を以下に示します。
これは、将来の開発に追加したいことの網羅的ではないリストです。これは明らかに変更される可能性がありますが、これから何があるかを適切に示しているはずです。彼らが終わったら、私は物事を刻みます。最終的には、コンテンツのほとんどが他の人が公開できるように、十分なツールを提供した段階に到達したいので、主に新しい機能の追加に取り組むことができます。
私はこのReadmeを、必ずしもコーディングに精通しているわけではない人が、彼らが非常に傾いている場合、ウェブサイトの開発に貢献する戦いの機会を持っているような方法で書き込もうとしました。クラブメンバーなど。そのため、あなたがすでに開発者である場合、これらの指示のいくつかは少し過度にさかのぼるように見えるかもしれないので、おそらくいくつかの要素をスキップすることができます。逆に、あなたがあまりにも技術に精通していないなら、あなたがサイトで私たちを助けたいなら、私はすべてを読むことをお勧めします - ちなみに、ここではどんなレベルの経験であれ（もしあれば）どんなレベルでも絶対に歓迎します。参加したい場合はメールを送ってください。
ほとんどの場合、これらは上昇して走るための裸の最小の要件です。
厳密には要件ではありませんが、私は個人的にWindowsで開発するので、当然、このガイドはWindows PCに開発環境を確立するように調整されています。 Windowsにいる場合は、まだ行っていない場合はWindows 10にアップグレードすることを強くお勧めします。
私は、あなたが何をしているのかを知っており、Windowsスタイルのラインエンディング（ CR+LF ）に固執すると仮定して、MACOまたはLinuxを使用して開発する貢献者に問題はありません。他のプラットフォームで開発を希望する人々に十分な需要がある場合は、これらの指示を将来拡張することができます。あなたがそのような開発者の1人なら、上記の指示でReadMeを更新するために自分でプルリクエストを送信してください！
GITはバージョン制御システム（VCS）と呼ばれるものであり、世界中で毎日使用してコードベースを管理するために何百万人もの開発者が何百万人もの開発者です。ソースコードリポジトリに加えられた変更の包括的な履歴と、複数の開発者が地球上のどこからでも同じコードベースでリモートで連携するのに役立つツールを提供します。新しいTriumph Mayflower Webサイトは現在、VCSとしてGITを使用して開発されており、開発プロセスに強固なバックボーンを提供しています。これらの手順に従って、WindowsにGitをインストールします。
WebサイトのソースコードはGitHub（現在これを読んでいるWebサイト）でホストされています。ソースコードをダウンロードして変更するには、GitHubアカウントにサインアップする必要があります。
ssh-keygencat ~/.ssh/id_rsa.pub > /dev/clipboardなじみのない人の場合、git "repository」または略して「リポジトリ」は、インターネット（またはローカルネットワーク）、さまざまな構成情報のさまざまな断片の様々な歴史のツリーを作成したすべての歴史ツリーを作成したすべての歴史ツリーを作成したすべての歴史ツリーを作成したすべての歴史ツリーを作成したすべての歴史ツリーの様々な歴史のツリーであるすべての歴史ツリーについて、リモートサーバーがどこにあるかについての情報を含む特定のGIT管理されたメタデータファイルと並んで、ソースコードファイルのセット（通常は集中的な「リモート」サーバーにどこかに集中型の「リモート」サーバーに保存されています）のセットです。誰がそれらを作成し、それらがどのようにして、開発者が同じコードベースで作業する他の開発者を妨害することなく、コードの孤立したコピーに取り組むことができる一時的な「ブランチ」からコードの主要なフローに統合された方法。
ウェブサイトに変更を加えて、それらの変更が与える影響を確認するには、 「クローン」操作と呼ばれるものでローカルマシンにソースコードをダウンロードする必要があります。これにより、ソースコードリポジトリのコピーがファイルシステムにダウンロードされ、GITが管理できるようになります。
C:DevelopmentRepositories C:devです。C:dev選択したと仮定します）：cd /c/devgit clone [email protected]:Stack-in-a-box/triumphmayflowerclub.com.gityesと入力して[Enter]を押します。cd triumphmayflowerclub.comリポジトリのローカルコピーをダウンロードした場合、Gitを構成する必要があります。
<name>最初の姓と姓に置き換えて名前を設定します。git config --local user.name "<name>"<email> githubアカウントに登録するために使用したメールアドレスに置き換えて、メールアドレスを設定します（スペースが含まれないため、前のステップに名前を設定するなど、メールアドレスのどちらの側にも引用符は必要ありません）：git config --local user.email <email>Jekyllは、「静的サイトビルダー」として知られています。これにより、ページの一般的に使用される部分（タイトル画像、ナビゲーションバー、ページフッター、プライマリスタイルなど）が特定のページで単純に参照される単一のファイルに「ファクタリング」することにより、コードベース全体で繰り返されるコードの量を減らすことができます。次に、Jekyllがサイトを「ビルド」するために実行されると、それを参照する各ソースファイルにFactored-Outコードを再挿入し、再構成されたファイルのセットを作成し、ライブサーバーに展開してWebブラウザーで開くことができます。
（注： 2020年7月である執筆時点では、JekyllはWSL 2を完全にサポートしていません。これは、 jekyll serve機能に必要なすべてのファイルシステムアップデートイベントを受け取っていないため、ソースファイルが変更されるたびに自動的にトリガーされた再構築を可能にするため、当時はWSL 1に固執します。）
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux<username>@<machine>:~$のように見えるbashプロンプトで、次のコマンドを実行して、インストールできるパッケージのリストを更新し、リポジトリにインストールしてインストールします（プロンプトが表示されるとUNIXパスワードを入力してください）。これには完了するまでに時間がかかります。sudo apt-get update -y && sudo apt-get upgrade -ysudo apt-add-repository ppa:brightbox/ruby-ng （ [Enter]を押して確認する）sudo apt-get updatesudo apt-get install ruby2.7 ruby2.7-dev build-essential （尋ねると「y」を入力）sudo gem updatesudo gem install jekyllJekyllがUbuntuターミナルセッションでインストールを終了し、リポジトリを保存するための場所としてC:dev選択したと仮定したら、次の手順を実行してローカル開発サーバーインスタンスをスピンアップします。
cd /mnt/c/dev/triumphmayflowerclub.comjekyll serveServer running... press ctrl-c to stop.表示されます。この時点で、Webブラウザーを開き、http：// localhost：4000/に移動して、ソースコードのローカルコピーからローカルに実行されているWebサイトを表示します。...done in x seconds. x新しい変更を生成するのにかかった秒数です）。この時点で、ブラウザにロードされたページを更新すると、サイトに変更が表示されます。（注： Jekyllは、新しいファイルが作成されたときに必ずしも気付かないので、ブラウザを更新してページにアクセスできない場合は、Jekyllを閉じて再度実行してみてください。新しいページをビルドに含める必要があります。）
開発に使用したいツールをお勧めします。これらはどれも必須ではなく、サイトでの作業を容易にするだけかもしれません。
CodeBaseにコミットする前にWebサイトに変更した変更をテストするために、Microsoft Edge（Windows 10に含まれる）やGoogle ChromeなどのWebブラウザー、できればChromiumベースのWebブラウザが必要です。
Webサイトのソースコードを変更する場合は、優れたテキストエディターが必要です。 Visual Studio Codeを使用することをお勧めします。これは、最新の軽量で、クロスプラットフォームであり、構文の強調表示、コード完了、Intellisense、プラグインの大規模なエコシステムなど、本格的なIDEに通常見られる多くの機能を備えています。バニラHTML、CSS、非常に時折JavaScriptを使用したシンプルなWebサイト開発の場合、構成変更や追加のプラグインなしで、箱から出して非常にうまく機能するはずです。
必須ではありませんが、サイトに含めるためのニュース記事やコンテンツを作成する場合に役立ちます。これは、コード標準（将来のある時点で文書化される）、 「スマート引用」 、ENなどの誤植的なユニコード文字を自動的に追加するためです。
Photoshopは私が写真編集に使用するものですが、ほとんどの編集者は簡単な編集タスクの良い仕事をする必要があります。
このプロジェクトに対する私のビジョンは、進化するにつれて、開発者と非技術的な貢献者の小さなコアチームを引き付け始めることです。そのため、オープンソースのウェブサイト開発で手を汚したい人がそうすることができる素晴らしい場所になります。また、より多くのチームメンバーがいることで、機能の追加、主要なリファクタリング、新しいテクノロジーの統合に取り組むために私を解放します。
最終的には、非技術的なクラブメンバーの著者を著者に送信し、最小限またはゼロの技術的介入でサイトにニュース記事やその他のコンテンツを提出できるようにするシンプルでオーダーメイドのCMSスタイルのオーサリングツールを開発する時間があれば、それは素晴らしいことです。現状では、このサイトは、近い将来、技術的に志向の人々によって手動で更新する必要がありますが、いつかこの段階に到達することを願っています。
ステージングまたはライブサイトのいずれかを展開するには、以下を実行します。
jekyll build_siteディレクトリに移動します。これは、ジキルがサイト生成プロセスから出力を配置する場所です。beta.triumphmayflowerclub.comまたはpublic_html subdirectoryのいずれかに移動します。index.htmlを削除し、 updating.htmlをindex.htmlに変更します。理想的には、これは誰かがホームページをロードできないリスクを最小限に抑えるための原子操作ですが、これが起こる時間枠と、私たちのウェブサイトにアクセスする比較的少数の人々は、これが実際には実際には問題ではないことを意味します。これは、継続的な展開のためにGitHubアクションの使用を開始すると、適切に対処されます。index.htmlを除き、左側のソースパネルのすべてのファイルを選択し、右手の宛先パネルにドラッグします。index.htmlソースパネルから宛先1にコピーして上書きします。展開が完了しました。 （Andi Emma Davies-Wilcox - Lead Developer）と一緒にインタッチする必要がある場合は、次のメールアドレスをご覧ください：[email protected]
Copyright©Stack-in-A-Boxソフトウェア2017–2021
Copyright©Triumph Mayflower Club 2005-2021
