TriumphMayFlowerClub.com 

The Triumph Mayflower Club adalah organisasi yang didedikasikan untuk pelestarian mobil klasik tahun 1950 -an, Mayflower, oleh produsen mobil Inggris Triumph. Klub itu sendiri dibentuk pada tahun 1974 dan membuat perampokan awal yang terbatas ke World Wide Web pada tahun 2005, dan kemudian saya (Andi, Project Loader) ditugaskan pada tahun 2017 untuk menjadikan mereka situs web baru dari awal ketika orang tua saya menjadi anggota. Klik di sini jika Anda tertarik membaca lebih lanjut tentang mobil dan klub.
Situs web baru ini ditulis dalam vanilla HTML5 untuk markup dokumen, CSS3 untuk gaya, sejumlah kecil JavaScript (ES6) dan dibangun menggunakan Jekyll sebagai generator situs statis untuk meminimalkan duplikasi kode. Ini dirancang untuk berjalan di browser "Evergreen" utama (IE Microsoft Edge berbasis kromium, Google Chrome, Mozilla Firefox, Apple Safari atau Opera), desktop atau seluler, tanpa masalah.
Situasi hosting saat ini untuk situs produksi hanya benar-benar cocok untuk menjadi hosting situs HTML statis (yay, kendala anggaran klub niche), jadi tidak benar-benar praktis untuk meng-host apa pun selain itu, misalnya tantangan rekayasa ASP.NET untuk melihat apa yang dapat mendorong fitur-fitur yang dapat mendorong hal-hal yang lebih baik untuk melihat-lihat apa yang dapat membuat fitur-fitur yang dapat dilakukan dengan baik untuk melihat apa yang dapat mendorong perbatasan dengan cara yang bisa melakukan hal-hal yang lebih baik untuk melihat ke atas dengan cara yang dapat melakukan perbaikan pada hal yang dapat dilakukan dengan baik untuk melihat batasan. Hosting untuk memungkinkan solusi klien-server yang lebih kompleks.
The different hosted versions of the website can be found at the following locations, where the canary server is the automatically-generated GitHub Pages site based-on the latest master , the staging area is a subdomain of the live website that we deploy to manually when we want to test-out new features and the production site is the current publicly-available website (also deployed to manually):
Oh, dan hanya untuk bersenang -senang, inilah situs web lama itu untuk perbandingan!
Sistem Rilis GitHub digunakan untuk menambah versi, tag dan rilis menerbitkan, dan merupakan satu -satunya sumber kebenaran untuk apa versi situs web saat ini. Tidak ada nomor versi yang secara eksplisit diadakan di file repo.
Karena basis kode ini adalah situs web, jelas tidak perlu mempertahankan cabang rilis apa pun untuk memperbaiki perbaikan, karena hanya akan ada satu situs langsung yang akan selalu memiliki perubahan terbaru di atasnya.
Ketika versi baru dari situs ini dirilis melalui GitHub, situs web akan menanyakan titik akhir API GitHub tertentu saat runtime untuk mendapatkan nomor versi rilis terbaru dan tanggal publikasi, yang kemudian ditampilkan kepada pengguna akhir di footer setiap halaman.
SEMVER digunakan, meskipun secara longgar, sebagai skema penomoran versi untuk situs web. Bagian utama , minor dan tambalan ditabrak untuk rilis sesuai dengan jenis perubahan berikut ke basis kode:
Ada dua rilis utama yang diterbitkan sejauh ini, yang tercantum di bawah ini dengan perubahan utama mereka, serta fitur mana yang saat ini sedang berlangsung untuk pembaruan besar berikutnya-setiap rilis historis yang pernah diterbitkan sejak live-live dengan situs baru ini dapat ditemukan di halaman rilis:
Ini adalah daftar yang tidak lengkap dari hal-hal yang ingin saya tambahkan dalam pengembangan di masa depan, tanpa urutan tertentu. Ini jelas dapat berubah, tetapi harus menjadi indikasi yang baik tentang apa yang akan terjadi. Saya akan mencentang seperti dan ketika mereka selesai. Saya akhirnya ingin mencapai tahap di mana saya menyediakan perkakas yang cukup sehingga sebagian besar konten dapat diterbitkan oleh orang lain, sehingga saya dibebaskan untuk bekerja terutama untuk menambahkan fitur baru.
Saya sudah mencoba menulis readme ini sedemikian rupa sehingga mereka yang tidak perlu akrab dengan pengkodean memiliki peluang berjuang untuk berkontribusi pada pengembangan situs web jika mereka cenderung; seperti anggota klub. Karena itu, jika Anda sudah menjadi pengembang, beberapa instruksi ini mungkin tampak sedikit terlalu banyak verbose, sehingga Anda mungkin dapat melewatkan beberapa elemen. Sebaliknya, jika Anda tidak terlalu paham teknologi, saya sarankan membaca semuanya jika Anda ingin dapat membantu kami dengan situs ini-kebetulan, Anda benar-benar disambut di sini tingkat pengalaman apa pun (jika ada), maka mengapa saya mencoba untuk menjadi seeksplisit mungkin dengan instruksi, jadi tolong jangan merasa tertunda jika terlihat luar biasa! Kirimi saya email jika Anda ingin terlibat tetapi bisa dilakukan dengan tangan untuk memulai, dan saya akan dengan senang hati membuat Anda pergi.
Sebagian besar, ini adalah persyaratan minimum untuk meningkatkan dan berjalan.
Meskipun tidak sepenuhnya persyaratan, saya pribadi mengembangkan di Windows sendiri sehingga, tentu saja, panduan ini dirancang untuk mendapatkan lingkungan pengembangan yang didirikan di Windows PC. Jika Anda berada di Windows maka saya sangat merekomendasikan peningkatan ke Windows 10 jika Anda belum melakukannya:
Saya tidak punya masalah dengan kontributor yang berkembang menggunakan macOS atau linux dengan asumsi Anda tahu apa yang Anda lakukan dan tetap berpegang pada ujung garis bergaya Windows ( CR+LF ). Saya dapat memperluas instruksi ini di masa depan jika ada permintaan yang cukup untuk orang yang ingin berkembang di platform lain - jangan ragu untuk mengirimkan permintaan tarik sendiri untuk memperbarui readme dengan instruksi tersebut jika Anda salah satu pengembang seperti itu!
Git adalah apa yang dikenal sebagai Sistem Kontrol Versi (VCS) dan itulah jutaan pengembang di dunia yang digunakan setiap hari untuk mengelola basis kode mereka. Ini memberikan riwayat perubahan yang komprehensif yang dibuat pada repositori kode sumber serta alat untuk membantu banyak pengembang bekerja bersama pada basis kode yang sama dari jarak jauh dari berpotensi di mana saja di planet ini. Situs web Triumph Mayflower baru saat ini sedang dikembangkan menggunakan GIT sebagai VC -nya untuk menyediakan tulang punggung yang solid untuk proses pengembangan kami. Ikuti langkah -langkah ini untuk menginstal git untuk windows:
Kode sumber situs web di -host di GitHub (situs web yang saat ini Anda baca ini). Untuk mengunduh dan mengubah kode sumber, Anda harus mendaftar untuk akun GitHub:
ssh-keygencat ~/.ssh/id_rsa.pub > /dev/clipboardFor those unfamiliar, a Git “repository” , or “repo” for short, is a set of source code files (usually stored on a centralised “remote” server somewhere) alongside specific Git-managed metadata files which contain information about where the remote server can be found on the internet (or local network), various pieces of configuration information and, most importantly , a complete history tree of all changes made to the codebase – what specific changes were made at each stage, when they Dibuat, yang membuat mereka dan bagaimana mereka diintegrasikan kembali ke dalam aliran kode utama dari "cabang" sementara di mana pengembang dapat bekerja pada salinan kode yang terisolasi tanpa mengganggu devs lain yang bekerja pada basis kode yang sama.
Untuk membuat perubahan pada situs web dan melihat efek perubahan tersebut, Anda harus mengunduh kode sumber ke mesin lokal Anda dalam apa yang disebut operasi "klon" . Ini akan mengunduh salinan repositori kode sumber ke sistem file Anda dan memungkinkannya dikelola oleh git:
C:dev ; Saya pribadi menyimpan repo saya di C:DevelopmentRepositories ).C:dev ):cd /c/devgit clone [email protected]:Stack-in-a-box/triumphmayflowerclub.com.gityes dan tekan [enter] .cd triumphmayflowerclub.comKetika Anda telah mengunduh salinan repositori lokal, Anda perlu mengkonfigurasi git sehingga secara otomatis memuji Anda sebagai penulis perubahan kode apa pun yang Anda buat:
<name> dengan nama depan dan belakang Anda:git config --local user.name "<name>"<email> dengan alamat email yang Anda gunakan untuk mendaftarkan akun GitHub Anda (Anda tidak memerlukan kutipan di kedua sisi alamat email seperti dengan mengatur nama Anda di langkah sebelumnya, karena tidak akan berisi spasi apa pun):git config --local user.email <email>Jekyll adalah apa yang dikenal sebagai "pembangun situs statis" . Hal ini memungkinkan kita untuk mengurangi jumlah kode yang diulangi di seluruh basis kode, dengan "memperhitungkan" bagian -bagian halaman yang umum digunakan (seperti gambar judul, bilah navigasi, footer halaman, gaya primer, dll.) Ke dalam file tunggal yang hanya dirujuk di halaman tertentu; Kemudian, ketika Jekyll dijalankan untuk "membangun" situs, itu akan memasukkan kembali kode yang diperhitungkan ke masing-masing file sumber yang merujuknya, membuat set file yang direkonstruksi yang kemudian dapat digunakan ke server langsung dan dibuka di browser web.
( Catatan: Pada saat penulisan, yaitu Juli 2020, Jekyll tidak sepenuhnya mendukung WSL 2, karena tidak menerima semua acara pembaruan sistem file yang diperlukan untuk fitur jekyll serve yang memungkinkan pembangunan kembali yang dipicu secara otomatis setiap kali file sumber berubah, tetap pada WSL 1 untuk saat ini.)
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linuxbash , yang seharusnya terlihat seperti <username>@<machine>:~$ , jalankan perintah berikut untuk memperbarui daftar paket yang dapat diinstal dan repositori untuk menginstalnya (masukkan kata sandi UNIX Anda saat diminta). Ini akan membutuhkan waktu untuk menyelesaikan:sudo apt-get update -y && sudo apt-get upgrade -ysudo apt-add-repository ppa:brightbox/ruby-ng (tekan [Enter] untuk mengonfirmasi)sudo apt-get updatesudo apt-get install ruby2.7 ruby2.7-dev build-essential (masukkan "y" saat ditanya)sudo gem updatesudo gem install jekyll Setelah Jekyll selesai menginstal, dalam sesi terminal Ubuntu, dan dengan asumsi Anda memilih C:dev sebagai lokasi Anda untuk menyimpan repositori Anda, lakukan langkah-langkah berikut untuk memutar instance server pengembangan lokal:
cd /mnt/c/dev/triumphmayflowerclub.comjekyll serveServer running... press ctrl-c to stop. akan ditampilkan. Pada titik ini, buka browser web dan navigasikan ke http: // localhost: 4000/untuk melihat situs web yang berjalan secara lokal dari salinan lokal Anda dari kode sumber....done in x seconds. Akan ditampilkan, di mana x adalah jumlah detik yang diperlukan untuk menghasilkan perubahan baru). Pada titik ini, Anda dapat menyegarkan halaman yang dimuat di browser Anda dan perubahan akan muncul di situs.( Catatan: Jekyll tidak selalu memperhatikan kapan file baru dibuat, jadi jika Anda menyegarkan browser Anda dan halaman tidak dapat diakses, cobalah menutup Jekyll dan menjalankannya lagi, dan halaman baru kemudian harus dimasukkan dalam build.)
Saya telah merekomendasikan beberapa alat yang mungkin ingin Anda gunakan untuk pengembangan. Tak satu pun dari ini diperlukan, mereka mungkin membuat bekerja di situs lebih mudah.
Anda akan memerlukan browser web, lebih disukai yang berbasis kromium, seperti Microsoft Edge (disertakan dengan Windows 10) atau Google Chrome, untuk menguji perubahan yang Anda lakukan ke situs web sebelum melakukan mereka ke basis kode.
Jika Anda akan memodifikasi kode sumber situs web, Anda akan memerlukan editor teks yang baik. Saya merekomendasikan menggunakan kode Visual Studio karena modern, ringan, lintas platform dan memiliki banyak fitur yang biasanya Anda temukan dalam IDE yang sepenuhnya seperti sintaksis, penyelesaian kode, intelisense dan ekosistem plugin yang besar. Untuk pengembangan situs web sederhana menggunakan vanilla HTML, CSS dan javascript yang sangat sesekali, itu harus bekerja dengan sangat baik di luar kotak tanpa perubahan konfigurasi atau plugin tambahan:
Not a necessity but it can be useful when authoring news articles or content for inclusion on the site, as it automatically adds typographical Unicode characters that are required by our code standards (to be documented at some point in the future), such as “smart quotes” , en dashes, etc. The full version of Word is obviously paid software as part of the Office suite of applications, but there are plenty of decent, free, open-source alternatives that offer similar functionality.
Photoshop adalah apa yang saya gunakan untuk pengeditan foto, tetapi sebagian besar editor harus melakukan pekerjaan pengeditan sederhana yang baik.
Visi saya untuk proyek ini, seiring berkembangnya, adalah bahwa ia akan mulai menarik tim inti pengembang kecil dan kontributor non-teknis, sehingga menjadi tempat yang bagus di mana mereka yang ingin membuat tangan mereka kotor dengan beberapa pengembangan situs web open-source dapat melakukannya. Memiliki lebih banyak anggota tim juga akan membebaskan saya untuk mengerjakan penambahan fitur, refotaktor besar dan mengintegrasikan teknologi baru.
Akhirnya, akan lebih baik jika saya punya waktu untuk mengembangkan set alat wewenang bergaya CMS yang sederhana dan dipesan lebih dahulu yang akan memungkinkan penulis anggota klub non-teknis dan mengirimkan artikel berita dan konten lainnya untuk dimasukkan di situs dengan intervensi teknis minim atau bahkan nol. Seperti berdiri, situs ini akan perlu diperbarui secara manual oleh orang-orang yang berpikiran secara teknis untuk masa mendatang, tetapi mudah-mudahan kita akan sampai pada tahap ini suatu hari nanti.
Untuk menggunakan pementasan atau situs live, lakukan yang berikut:
jekyll build_site di akar repo Anda, karena di sinilah Jekyll menempatkan output dari proses pembuatan situs.beta.triumphmayflowerclub.com atau public_html , tergantung pada apakah Anda menggunakan masing-masing pementasan atau situs langsung.index.html dan ganti nama updating.html ke index.html . Idealnya, ini akan menjadi operasi atom untuk meminimalkan risiko seseorang yang tidak dapat memuat beranda, tetapi jangka waktu di mana ini terjadi dan orang -orang yang relatif sedikit yang mengakses situs web kami berarti bahwa ini bukan masalah dalam praktiknya. Ini akan dibahas dengan benar setelah kami mulai menggunakan tindakan GitHub untuk penyebaran berkelanjutan.index.html , dan seret ke seberang ke panel tujuan kanan.index.html dari panel sumber ke tujuan satu untuk menimpanya. Penempatan sekarang selesai. Jika Anda perlu tersentuh dengan saya (Andi Emma Davies-Wilcox-Pengembang utama), silakan lakukan di alamat email berikut: [email protected]
Hak Cipta © Perangkat Lunak Stack-in-A-Box 2017–2021
Hak Cipta © Triumph Mayflower Club 2005-2021