triumphmayflowerclub.com
ved Mark Smith's email address
Triumphmayflowerclub.com 
Triumph Mayflower Club - это организация, посвященная сохранению классического автомобиля 1950 -х годов Mayflower, британским производителем автомобилей Triumph. Сам клуб сформировался в 1974 году и совершил свой первоначальный, ограниченный наклон во всемирной паутине еще в 2005 году, а затем я (Andi, Savingerser) в 2017 году был введен в эксплуатацию для создания их нового веб -сайта с нуля, когда мои родители стали участниками. Нажмите здесь, если вы заинтересованы в прочтении больше о машине и клубе.
Этот новый веб -сайт написан в Vanilla HTML5 для разметки документов, CSS3 для стиля, небольшое количество JavaScript (ES6) и создан с использованием Jekyll в качестве статического генератора сайта для минимизации дублирования кода. Он предназначен для работы в любом крупном «вечнозеленом» браузере (т.е. на основе хрома Microsoft Edge, Google Chrome, Mozilla Firefox, Apple Safari или Opera), настольного компьютера или мобильных устройств, без проблем.
Текущая ситуация с хостингом для производственного сайта действительно подходит только для размещения статического HTML-сайта (Yay, бюджетные ограничения нишевого клуба), поэтому не практично размещать что-либо, кроме этого, например, приложение ASP.NET Core Server для более продвинутых функций, поэтому я считаю, что это немного инженерия, чтобы увидеть, что я могу повысить кнопку, на все возможное, чтобы ускорить, что на все возможное, чтобы ускорить, на все возможное, чтобы ускорить. Разрешить более сложное решение для клиента.
Различные размещенные версии Веб-сайта можно найти в следующих местах, где Canary Server представляет собой автоматически сгенерированный сайт GitHub Pages, основанный на последнем master , область постановки является поддоменом живого веб-сайта, который мы используем вручную, когда мы хотим протестировать новые функции, а производственный сайт является текущим общедоступным веб-сайтом (также развернутым в маловероятном).
О, и просто для удовольствия, вот как выглядел старый сайт для сравнения!
Система Github Leleases используется для увеличения версии, тега и публикации выпусков, и является единственным источником истины для текущей версии веб -сайта. Никакие номера версий не проводится в файлах репо.
Поскольку эта кодовая база является веб -сайтом, очевидно, нет необходимости поддерживать какие -либо филиалы релизов для обработки перевозки, так как когда -либо будет только один живой сайт, на котором всегда будут последние изменения.
Когда новая версия сайта будет выпущена через GitHub, веб -сайт будет запросить конкретную конечную точку API GitHub во время выполнения, чтобы получить как номер версии последнего выпуска, так и дату публикации, которая затем отображается конечному пользователю в нижнем колонтитуле каждой страницы.
SEMVER используется, хотя и свободно, в качестве схемы нумерации версий для веб -сайта. Основные , незначительные и патч -детали сталкиваются для выпуска в соответствии со следующими типами изменений в кодовую базу:
До сих пор было опубликовано два основных релиза, которые перечислены ниже с их ключевыми изменениями, а также какие функции в настоящее время выполняются для следующего крупного обновления-каждый исторический релиз, когда-либо опубликованный с момента перехода с этим новым сайтом, можно найти на странице выпусков:
Это неэктактный список вещей, которые я хотел бы добавить в будущем разработке, в любом случае. Это, очевидно, может быть изменено, но это должно быть хорошим признаком того, что будет. Я выступаю, как и когда они закончат. Я хочу в конечном итоге добраться до стадии, когда я предоставил достаточно инструментов, чтобы большинство контента могли быть опубликованы другими людьми, чтобы я освободил работу в основном над добавлением новых функций.
Я пытался написать этот Readme таким образом, что у тех, кто не обязательно знаком с кодированием, имели шанс внести свой вклад в разработку веб -сайта, если они так склонны; такие как члены клуба. Таким образом, если вы уже являетесь разработчиком, некоторые из этих инструкций могут показаться немного чрезмерно бесплодными, так что вы, вероятно, можете пропустить некоторые элементы. И наоборот, если вы не слишком технологически подкованные, я рекомендую прочитать все, если вы хотите иметь возможность помочь нам с сайтом-кстати, вы абсолютно приветствуют здесь любой уровень опыта (если есть), следовательно, почему я старался быть максимально явным с помощью инструкций, поэтому, пожалуйста, не чувствуйте себя поставленным, если он выглядит подавляющим! Пришлите мне электронное письмо, если вы хотите принять участие, но могли бы сделать руку, и я был бы рад заставить вас начать.
По большей части, это требования к голым минимумам для подъема.
Хотя это и не требование, я лично разрабатываю в Windows, что, естественно, это руководство адаптировано для получения среды разработки, созданной на ПК Windows. Если вы находитесь в Windows, я настоятельно рекомендую обновить до Windows 10, если вы еще этого не сделали:
У меня нет проблем с разработкой участников с использованием MacOS или Linux, предполагая, что вы знаете, что вы делаете, и придерживайтесь окончания линий в стиле Windows ( CR+LF ). Я могу расширить эти инструкции в будущем, если будет достаточно спроса на людей, желающих разработать на других платформах - не стесняйтесь отправить запрос на то, чтобы вы могли обновить Readme с указанными инструкциями, если вы один из таких разработчиков!
GIT - это то, что известно как система управления версиями (VCS), и это то, что миллионы разработчиков во всем мире каждый день используют для управления своими кодовыми базами. Он предоставляет полную историю изменений, внесенных в хранилище исходного кода, а также инструменты, помогающие нескольким разработчикам работать вместе на одной и той же кодовой базе удаленно с потенциально в любом месте на планете. Новый веб -сайт Triumph Mayflower в настоящее время разрабатывается с использованием GIT в качестве своего VCS для обеспечения прочной основы для нашего процесса разработки. Следуйте этим шагам, чтобы установить GIT для Windows:
Исходный код веб -сайта размещен на GitHub (веб -сайт, на котором вы сейчас читаете). Чтобы загрузить и изменить исходный код, вам нужно зарегистрироваться на учетную запись GitHub:
ssh-keygencat ~/.ssh/id_rsa.pub > /dev/clipboardДля тех, кого незнакомые, «хранилище» GIT, или «репо» для короткометражных, представляют собой набор файлов исходного кода (обычно хранящийся на централизованном «удаленном» сервере где-то) наряду с конкретными файлами метаданных, управляемых GIT, которые содержат информацию о том, где удаленный сервер может быть найден в Интернете (или локальной сети), различные части конфигурации, и, что наиболее важно , полное дерево истории во всех изменениях всех изменений в код, созданная на снимке, была в целом, что было в целом, в целом, на все изменения, которые были в целях, были вновь, были на смене. Сделано, кто сделал их, и как они были интегрированы в основной поток кода из временных «филиалов» , где разработчики могут работать над изолированными копиями кода, не мешая другим разработкам, работающим над одной и той же кодовой базой.
Чтобы внести изменения на веб -сайт и увидеть эффект, которые оказывают эти изменения, вам нужно будет загрузить исходный код на свою локальную машину в так называемой операции «клон» . Это загрузит копию репозитория исходного кода в вашу файловую систему и позволит им управлять GIT:
C:dev ; я лично держу свои репозиты в C:DevelopmentRepositories ).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 запускается, чтобы «построить» сайт, он переведет код, основанный на каждом из исходных файлов, которые ссылаются на него, создавая реконструированный набор файлов, которые затем можно развернуть на живом сервере и открыть в веб-браузере.
( Примечание. На момент написания статьи, в июле 2020 года, Jekyll не полностью поддерживает WSL 2, так как он не получает все события обновления файловых систем, которые требуются для функции jekyll serve , которая позволяет автоматически инициировать восстановление при изменении исходных файлов, поэтому придерживайтесь WSL 1.
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linuxbash , которая должна выглядеть как -то вроде <username>@<machine>:~$ , запустите следующую команду, чтобы обновить список пакетов, которые могут быть установлены, и репозитории для их установки (введите свой пароль 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 jekyll После того, как Jekyll закончил установку, в сеансе терминала Ubuntu, и предполагая, что вы выбрали C:dev в качестве места для хранения ваших репозитории, выполните следующие шаги, чтобы развернуть локальный экземпляр сервера разработки:
cd /mnt/c/dev/triumphmayflowerclub.comjekyll serveServer running... press ctrl-c to stop. будет отображаться. На этом этапе откройте веб -браузер и перейдите по адресу http: // localhost: 4000/для просмотра веб -сайта, работающего локально из локальной копии исходного кода....done in x seconds. Будет показано, где x -это количество секунд, необходимых для создания новых изменений). На этом этапе вы можете обновить страницу, загруженную в ваш браузер, и изменения появятся на сайте.( Примечание: Jekyll не всегда замечает, когда создаются новые файлы, поэтому, если вы обновляете свой браузер, а страница недоступна, попробуйте закрыть Jekyll и запустить его снова, а затем новая страница должна быть включена в сборку.)
Я рекомендовал несколько инструментов, которые вы можете использовать для разработки. Ничто из этого не требуется, они просто могут облегчить работу на сайте.
Вам понадобится веб-браузер, предпочтительно тот, который на основе хрома, такой как Microsoft Edge (включенная в Windows 10) или Google Chrome, чтобы проверить любые изменения, которые вы вносите на веб-сайт, прежде чем принять их в кодовую базу.
Если вы собираетесь изменить исходный код веб -сайта, вам понадобится хороший текстовый редактор. Я рекомендую использовать код Visual Studio в качестве современного, легкого, кроссплатформенного и имеет много функций, которые вы обычно найдете в полностью отработанной IDE, таких как выделение синтаксиса, завершение кода, Intellisense и большая экосистема плагинов. Для простой разработки веб -сайта с использованием ванильного HTML, CSS и очень случайного JavaScript он должен работать очень хорошо из коробки без каких -либо изменений конфигурации или дополнительных плагинов:
Не необходимость, но это может быть полезно при создании новостных статей или контента для включения на сайт, поскольку он автоматически добавляет типографских символов Unicode, которые требуются нашими стандартами кода (чтобы быть задокументированными в будущем), таких как «умные цитаты» , en rahes и т. Д. Полная версия Word является очевидным программным обеспечением как часть офисной комплексной комплексной, но есть в многочисленных, но в размере, что можно найти в размере.
Photoshop - это то, что я использую для редактирования фотографий, но большинство редакторов должны выполнять хорошую работу по простым задачам редактирования.
Мое видение этого проекта, как он развивает, состоит в том, что он начнет привлекать небольшую основную команду разработчиков и нетехнических участников, так что это становится отличным местом, где могут это сделать те, которые хотят испачкать свои руки с помощью разработки веб-сайта с открытым исходным кодом. Наличие большего количества членов команды также освободит меня от работы над дополнениями, основными рефактовами и интеграцией новых технологий.
В конце концов, было бы здорово, если бы у меня было время разработать простой набор инструментов создания в стиле CMS, которые позволили бы нетехническим членам клуба автора и отправляли новостные статьи и другой контент для включения на сайт с минимальным или даже нулевым техническим вмешательством. В настоящее время сайт потребуется вручную обновлять технически ориентированных людей в обозримом будущем, но, надеюсь, когда-нибудь мы доберемся до этой стадии.
Чтобы развернуть сайт постановки или живого, выполните следующее:
jekyll build_site в корне вашего репо, так как именно здесь Джекилл ставит вывод из процесса генерации сайта.beta.triumphmayflowerclub.com , либо public_html подкаталог, в зависимости от того, развертываете ли вы на стадию или живой сайт соответственно.index.html и переименовать updating.html в index.html . В идеале, это была бы атомная операция, чтобы минимизировать риск того, что кто -то не сможет загрузить домашнюю страницу, но сроки, в которые это происходит, и относительно немногие люди, получающие доступ к нашему веб -сайту, означают, что на практике это не проблема. Это будет решено должным образом, как только мы начнем использовать действия GitHub для непрерывного развертывания.index.html и перетащите их на правую панель назначения.index.html из исходной панели в пункт назначения, чтобы перезаписать его. Развертывание теперь завершено. Если вам нужно связаться со мной (Andi Emma Davies-Wilcox-ведущий разработчик), пожалуйста, сделайте это по следующему адресу электронной почты: [email protected]
Copyright © Sack-In-Box Software 2017–2021
Copyright © Triumph Mayflower Club 2005-2021
