Update readme and add normilize.css + reset.css

Co-authored-by: Anton.AE <ab.an.ev@yandex.ru>
Reviewed-on: #1

.htaccess

@@ -0,0 +1,14 @@
+<IfModule mod_rewrite.c>
+    # Редирект: ...// -> .../
+    RewriteCond %{REQUEST_URI} (.*)\/\/$
+    RewriteRule ^(.*)$ https://%{HTTP_HOST}/%1/ [R=301,L]
+
+    # Редирект: с www -> без www
+    RewriteCond %{HTTP_HOST} ^www\.(.*)$
+    RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
+
+    # Редирект: HTTP -> HTTPS
+    RewriteCond %{HTTP:X-Forwarded-Proto} !https
+    RewriteCond %{HTTPS} off
+    RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
+</IfModule>

README.md

@@ -1,9 +1,36 @@
-# Требования к верстке
+## **Требования к верстке**
 
-
+### **С точки зрения веб-разработки:**
-## С точки зрения веб-разработки:
 * верстаем на чистом HTML/CSS с использованием flex и grid (без подключение библиотек типа bootstrap и т.п.)
-* при именовании блоков используем методологию **БЭМ в стиле "Two Dashes"**:
+* соблюдаем Scope-ориентированный подход:
+    - каждую секцию/экран именуем **уникальным** классом-родителем, от которого строим CSS-селектор для дочерних элементов, что ограничивает область ваших стилей только внутри секции/экрана, не влияя на другие части сайта.
+    
+    - пример:  <br>
+    
+    HTML:
+    ```
+    <section class="my-namespace">
+        <h1>Новый заголовок</h1>
+        <button class="my-button">Кнопка</button>
+    </section>
+    ```
+
+    CSS:
+
+    ```
+    .my-namespace h1 {
+        font-size: 24px;
+        color: #333;
+    }
+
+    .my-namespace .my-button {
+        background-color: #007BFF;
+        color: #fff;
+    }
+    ```
+
+
+* чтобы дополнительно структурировать CSS при именовании блоков используем методологию **БЭМ в стиле "Two Dashes"**:
     `block-name__elem-name--mod-name--mod-val`
     + имена записываются латиницей в нижнем регистре
     + для разделения слов в именах БЭМ-сущностей используется дефис (-)
@@ -12,10 +39,12 @@
     + значение модификатора отделяется от его имени двумя дефисами (--)
 * из конечного HTML-файла убрать все комментарии, если такие имеются 
 * все медиазапросы пишутся в отдельных файлах (которые мы подготовили) для того чтобы оптимизировать скорость загрузки; если используется препроцессор, то не нужно в классе каждого блока использовать импорты медиа запросов, а наоборот выносим  пример можно посмотреть на ["видео"](https://www.youtube.com/watch?v=9uaENbRyVT4)
-<!-- * для всех страниц прописывать уникальный класс в \<body\>, от которого строить CSS-правила  -->
+* **частая ошибка:** верстальщик берет изображения/видео из макета и не задает им адаптивную ширину/высоту, и на моменте сдачи верстки не заметно косяков, а вот когда мы переходим к натяжке и медиаматериалы начинают выводиться в шаблон динамически и уже разных форматов (ШИРИНАxВЫСОТА), тогда верстка начинает плыть. Чтоб такое избежать проверяйте на как себя ведет элемент при замене слишком большой/маленькой картинки. 
+* **ВАЖНО:** если верстка делается для многостраничного сайта (особенно на CMS), то для всех страниц прописывать уникальный класс в \<body\>, от которого строить все CSS-правила на этой странице + для кажой станицы использовать свои отдельные CSS-файлы
+* подключаем вначале normalize.min.css и reset.min.css, чтобы сбросить глобальные стили и устранить влияние наследуемых правил.
+* шрифты и глобальные переменные выносим в отдельный файл (у нас это *gp-style-core.css*)
 
-
+### **С точки зрения SEO:**
-## С точки зрения SEO:
 * все теги использовать строго по назначению! Текстовые (strong, b, i, em, h1-h6… p) используем только в текстовых блоках и заголовках. Для дизайна используем div и span. Например не нужно втыкать в подвал, шапку или формы захвата h4 или закрывать просто крупный текст, который не является заголовком в h2.
 * на странице должен быть только один заголовок первого уровня (h1) 
 * должны присутствовать все основные теги и атрибуты — html, head, body, title, description, lang=ru, content=html, charset=utf8
@@ -23,13 +52,33 @@
 * для \<img\> самостоятельно проставляем атрибут alt="", со значением описывающим того что изображено на картинке
 
 
-## Оптимальный порядок действий
+## **Порядок работы**
-1. Сначала определить CSS-переменные для основных цветов/градиентов, начертаний шрифтов (толщина, размер, модификация, межтрочный интервал) и занести в специально подгтовленный CSS-файл style-core.css 
+
-2. Все шрифты выкачать и сохранить локально в директорию /assets/fonts/ и подключить их в файле style-core.css
+### **Подготовка окружения для локальной разработки**
-3. Далее начинать стоит с верстки UI kit (должен быть предоставлен в макете дизайнером), для того чтобы переиспользовать готовые элементы по ходу верстки макетов. Для удобства подготовлен файл "ui_kit.html" 
+1. Выкачивать локально на свой компьютер один из 2х шаблонов (по веткам: 1 - master, 2 - with-phpmailer) командой: `git clone -b ${branch_name} https://git.good-production.xyz/Good-Production/template-for-verstka.git`
-3. Как UI kit будет готов, можно смело переходить к верстке основных листов макета "*.html" и просто использовать готовые классы из style-core.css
+
+заменить переменную: 
+`${branch_name}` -- на "master", если достаточно только отправки форм в ТГ, либо "with-phpmailer", если нужна отправка на почту средствами PHP (без использования плагинов CMS)
+
+2. Далее создать свою ветку командой: `git checkout -b ${project_name}--${name}`
+3. Приступить к локальной разработке в созданной ветке
+4. Для демонстрации работы пушить свои комиты в созданную ветку командой: `git push origin ${project_name}--${name}`
+    - во время push для авторизации понадобиться логин/пароль: `freelancer/freelancerfreelancer00`
+5. Отписать в чат, чтоб руководитель проектом посмотрел результат и выкачал его на тестовый стенд
+
+в командах заменить переменные: 
+`${project_name}` -- условное названия проекта (как варинат использовать домен сайта)
+`${name}` -- имя/ник исполнителя
 
 
-### Примечания
+## **Оптимальный порядок непосредственно в процессе верстки**
+1. Сначала определить CSS-переменные для основных цветов/градиентов, начертаний шрифтов (толщина, размер, модификация, межтрочный интервал) и занести в специально подгтовленный CSS-файл `style-core.css` 
+2. Все шрифты выкачать и сохранить локально в директорию `/assets/fonts/` и подключить их в файле `style-core.css`
+3. Далее начинать стоит с верстки UI kit (должен быть предоставлен в макете дизайнером), для того чтобы переиспользовать готовые элементы по ходу верстки макетов. Стили для UI kit писать так же в файл `style-core.css`. 
+Саму HTML-верстку для UI kit делать в файле `ui_kit.html` 
+3. Как UI kit будет готов, можно смело переходить к верстке основных листов макета "*.html" и просто использовать готовые классы из `style-core.css`
+
+
+### **Примечания**
 
 Для работы с Figma рекомендуем использовать плагин ["Inspect Styles"](https://www.figma.com/community/plugin/1254262542670221199) для инспевтирования CSS-свойсв.

assets/css/gp-style-core.css

@@ -1,3 +1,8 @@
+/* Переменные, шрифты, UI kit */
+
+
+
+
 /* 
 
 ШАБЛОН использования глобальных переменных:

assets/css/gp-style-desktop.css

@@ -1,4 +1,18 @@
-/* Стили для лептопов  */
+/* Основные стили для компьютера */
-@media only screen and (min-width: 992px) and (max-width: 1400px) {
 
-}
+
+
+/* писать сюда... */
+
+
+
+
+
+
+
+
+
+/* Стили для лептопов  */
+/* @media only screen and (min-width: 992px) and (max-width: 1400px) {
+
+} */

assets/css/normalize.min.css

@@ -0,0 +1,2 @@
+/*! normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */html{line-height:1.15;-webkit-text-size-adjust:100%}body{margin:0}main{display:block}h1{font-size:2em;margin:.67em 0}hr{box-sizing:content-box;height:0;overflow:visible}pre{font-family:monospace,monospace;font-size:1em}a{background-color:transparent}abbr[title]{border-bottom:none;text-decoration:underline;text-decoration:underline dotted}b,strong{font-weight:bolder}code,kbd,samp{font-family:monospace,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}img{border-style:none}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;line-height:1.15;margin:0}button,input{overflow:visible}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{border-style:none;padding:0}[type=button]:-moz-focusring,[type=reset]:-moz-focusring,[type=submit]:-moz-focusring,button:-moz-focusring{outline:1px dotted ButtonText}fieldset{padding:.35em .75em .625em}legend{box-sizing:border-box;color:inherit;display:table;max-width:100%;padding:0;white-space:normal}progress{vertical-align:baseline}textarea{overflow:auto}[type=checkbox],[type=radio]{box-sizing:border-box;padding:0}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}details{display:block}summary{display:list-item}template{display:none}[hidden]{display:none}
+/*# sourceMappingURL=normalize.min.css.map */

assets/css/reset.min.css

@@ -0,0 +1 @@
+*{padding:0;margin:0;border:none}*,::after,::before{box-sizing:border-box}a,a:hover,a:link,a:visited{text-decoration:none}aside,footer,header,legend,main,nav,section{display:block}h1,h2,h3,h4,h5,h6,p{font-size:inherit;font-weight:inherit}ul,ul li{list-style:none}img{vertical-align:top}img,svg{max-width:100%;height:auto}address{font-style:normal}button,input,select,textarea{font-family:inherit;font-size:inherit;color:inherit;background-color:transparent}input::-ms-clear{display:none}button,input[type=submit]{display:inline-block;box-shadow:none;background:0 0;cursor:pointer}button:active,button:focus,input:active,input:focus{outline:0}button::-moz-focus-inner{padding:0;border:0}label{cursor:pointer}

index.html

@@ -8,15 +8,64 @@
         <meta name="description" content="SEO Description">
         <link rel="shortcut icon" href="/assets/img/favicon.ico?v=1.0">
 
+        <!-- Сбрасываем глобальные стили -->
+        <link rel="stylesheet" href="/assets/css/normalize.min.css">
+        <link rel="stylesheet" href="/assets/css/reset.min.css">
+        <!-- Базовые стили -->
         <link rel="stylesheet" href="/assets/css/gp-style-core.css?v=1.0">
-        <link rel="stylesheet" media="screen and (min-width: 1720px)" href="/assets/css/gp-style-ultra.css?v=1.0">
+        <link rel="stylesheet" href="/assets/css/gp-style-desktop.css?v=1.0">
-        <link rel="stylesheet" media="screen and (max-width: 1720px)" href="/assets/css/gp-style-desktop.css?v=1.0">
+        <!-- Адаптив -->
-        <link rel="stylesheet" media="screen and (max-width: 1024px)" href="/assets/css/gp-style-tablet.css?v=1.0">
+        <link rel="stylesheet" media="screen and (min-width: 1400px)" href="/assets/css/gp-style-ultra.css?v=1.0">
-        <link rel="stylesheet" media="screen and (max-width: 480px)" href="/assets/css/gp-style-mobile.css?v=1.0">
+        <link rel="stylesheet" media="screen and (max-width: 992px)" href="/assets/css/gp-style-tablet.css?v=1.0">
+        <link rel="stylesheet" media="screen and (max-width: 576px)" href="/assets/css/gp-style-mobile.css?v=1.0">
+    
+
+        <!-- Яндекс.Вебмастер + Google Search Console -->
+        <meta name="yandex-verification" content="XXXXXXXXXXXXXXXXX" />
+        <meta name="google-site-verification" content="XXXXXXXXXXXXXXXXX" />
+        <!-- /Яндекс.Вебмастер + Google Search Console -->
+
+        <!-- Yandex.Metrika counter -->
+        <script type="text/javascript">
+            (function (m, e, t, r, i, k, a) {
+                m[i] = m[i] || function () { (m[i].a = m[i].a || []).push(arguments) };
+                m[i].l = 1 * new Date();
+                for (var j = 0; j < document.scripts.length; j++) { if (document.scripts[j].src === r) { return; } }
+                k = e.createElement(t), a = e.getElementsByTagName(t)[0], k.async = 1, k.src = r, a.parentNode.insertBefore(k, a)
+            })
+                (window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym");
+
+            ym(XXXXXX, "init", { // XXXXXX - счетчик
+                clickmap: true,
+                trackLinks: true,
+                accurateTrackBounce: true,
+                webvisor: true,
+                ecommerce: "dataLayer"
+            });
+        </script>
+        <noscript>
+            <div><img src="https://mc.yandex.ru/watch/85828806" style="position:absolute; left:-9999px;" alt="" /></div>
+        </noscript>
+        <!-- /Yandex.Metrika counter -->
+    
+    
     </head>
     <body>
 
         
+        <!-- Пример формы для отправки в Телеграмм (обработчик send-telegram.php) -->
+        <form class="form" method="post" action="/send-telegram.php">
+            <div class="form__item">
+                <input class="form__input" type="text" name="name" required>
+                <label class="form__label">Ваше имя</label>
+            </div>
+            <div class="form__item">
+                <input class="form__input" type="text" name="phone" required>
+                <label class="form__label">Номер телефона</label>
+            </div>
+            <input class="form__input btn" type="submit" value="Отправить">
+        </form>
+
 
         <script src="/assets/js/gp-main.js"></script>
     </body>

send-telegram.php

@@ -0,0 +1,38 @@
+<?php
+/* Пример из: https://vc.ru/dev/158136-kak-otpravlyat-zayavki-s-lendinga-pryamo-v-telegram */
+
+
+//В переменную $token нужно вставить токен, который нам прислал @botFather
+$token = "1094153697:AAFiLXXXXXLl0hRDsxBij1lddKydKxSSsOg04";
+
+//Сюда вставляем chat_id
+$chat_id = "-40XXXX740";
+
+//Определяем переменные для передачи данных из нашей формы
+if ($_POST['phone'] !== '') {
+    $name = ($_POST['name']);
+    $phone = ($_POST['phone']);
+
+    //Собираем в массив то, что будет передаваться боту
+    $arr = array(
+        'Имя:' => $name,
+        'Телефон:' => $phone
+    );
+
+    //Настраиваем внешний вид сообщения в телеграме
+    foreach($arr as $key => $value) {
+        $txt .= "<b>".$key."</b> ".$value."%0A";
+    };
+
+    //Передаем данные боту
+    $sendToTelegram = fopen("https://api.telegram.org/bot{$token}/sendMessage?chat_id={$chat_id}&parse_mode=html&text={$txt}","r");
+
+    //Выводим сообщение об успешной отправке
+    if ($sendToTelegram) {
+        echo 'Спасибо! Ваша заявка принята. Мы свяжемся с вами в ближайшее время.';
+    }else{
+        echo 'Что-то пошло не так. Попробуйте отправить форму ещё раз.';
+    }
+}
+
+?>