annotate .cms/mini/instruction.ru_RU.UTF-8.html @ 0:78edf6b517a0 draft

24.10
author Coffee CMS <info@coffee-cms.ru>
date Fri, 11 Oct 2024 22:40:23 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
1 <!doctype html>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
2 <html lang="ru">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
3
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
4 <head>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
5 <meta charset="utf-8">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
6 <title>Заготовки для шаблона</title>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
7 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
8 <link rel="stylesheet" href="styles.css">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
9 <style>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
10 /*Инструкция использует css стили темы сайта, а прописанные стили ниже дополняют оформление только для инструкции*/
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
11 body {grid-template-areas: unset; grid-template-rows: unset; align-content: start; padding: 0 0 2rem 0;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
12 main {grid-area: unset; padding: 0;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
13 main:first-child {padding-bottom: 2rem;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
14 main > h2 {margin-bottom: 1rem;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
15 main > p {margin-bottom: 0.5rem;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
16 [data-copy] {justify-self: center; padding: 0.4rem 0.7rem; min-width: 110px;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
17 pre {word-wrap: break-word; word-break: break-all; margin: 0;padding: 0.5rem;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
18 .block-code {display: grid; row-gap: 1rem; padding: 3rem 0; border-bottom: 1px solid #999999;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
19 body > main:first-child {border-bottom: 1px solid #999999; padding-top: 2rem;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
20 main .code {overflow-x: auto; background-color: white;}
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
21 </style>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
22 </head>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
23
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
24 <body>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
25
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
26 <main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
27 <h2>Инструкция по шаблоу mini</h2>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
28 <p>Ниже хранятся фрагменты кода для быстрого копирования и вставки. Вы можете дополнить эту инструкцию своими примерами кода через пункт Шаблон, отредактировав файл instruction.ru_RU.UTF-8.html. Но сначала сделайте копию шаблона, иначе из-за измененных файлов не сможете обновлять CMS.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
29 <p>Скопированный код вставьте в нужное место страницы, выделите его и выровняйте нажатием сочетания клавиш - [Shit] + [Tab].</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
30
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
31 <h2>Как создать свой шаблон</h2>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
32 <p>Шаблон mini - это простой стартовый шаблон. Он находится в папке .cms/mini/. Создайте копию этой папки, например, с названием .cms/mini2/, переключитесь на шаблон mini2 и уже в этой папке изменяйте файлы под себя. Если же вы будете править файлы в оригинальном шаблоне, то CMS потом не сможет обновиться, будет сообщать, что файлы изменены и поэтому она не хочет перезатирать ваши наработки.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
33 <h2>Блог</h2>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
34 <p>С помощью шаблона mini можно создать блог с бесконечной подгружаемой лентой тизеров статей. Тизер переводится как "приманка", это часть статьи, не обязательно ее начало, которая интригует к прочтению всей статьи. Для этого нужно для одной из страниц, которая будет лентой, задать шаблон blog, а остальным страницам, которые будут статьями в блоге, задать шаблоны post. А внутри постов выделить тизеры с помощью открывающего и закрывающего html-комментария.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
35 <pre>&lt;!-- preview-start -->
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
36 &lt;p>тут расположен текст тизера&lt;/p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
37 &lt;p>можно с html-тегами, а можно и без&lt;/p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
38 &lt;!-- preview-end --></pre>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
39 <p>Но если не отметить тизер специально, то будут взяты первые 500 символов статьи, при этом очищается html-разметка. Старайтесь задавать тизеры вручную чтобы они выглядели красиво и заинтересовывали читателей.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
40 <h2>Главная</h2>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
41 <p>Так же имеется шаблон frontpage, который как и blog выводит тизеры страниц с шаблоном post, но только последние 6 штук. Он подойдет для создания главной страницы которая не должна быть лентой. В этом шаблоне php-код сильно упрощен по сравнению с blog.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
42 <h2>Заготовки</h2>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
43 <p>Ниже представлены заготовки, которые вы можете использовать для оформления страниц сайта. Выберите нужный вам блок и нажмите кнопку Копировать под ним. Затем вставьте скопированный блок в редактируемую страницу.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
44 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
45
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
46
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
47 <div class="block-code">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
48 <main data-example=lbox-example>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
49 <img class="lbox" alt="Баннер" src="/mini/banner.jpg" width="1920" height="700">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
50 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
51 <button data-copy=lbox-example>Копировать</button>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
52 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
53
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
54
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
55
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
56 <div class="block-code">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
57 <main data-example=banner>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
58 <img class="banner" alt="Баннер" src="/mini/banner.jpg" width="1920" height="700">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
59 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
60 <button data-copy=banner>Копировать</button>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
61 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
62
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
63
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
64
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
65 <div class="block-code">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
66 <main data-example=cite>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
67 <blockquote>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
68 <p>Только работа дает ответы на все вопросы.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
69 <p class="author">Николай Замяткин</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
70 </blockquote>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
71 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
72
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
73 <button data-copy=cite>Копировать</button>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
74 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
75
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
76 <div class="block-code">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
77 <main data-example=code>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
78 <pre class="ignorgap"><code><p>Заголовок</p>&lt;?php
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
79 $cms['modules']['test.mod.php'] = array(
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
80 'name' =&gt; 'Test',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
81 'description' =&gt; 'Test module',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
82 'url_title' =&gt; 'Module page',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
83 'url_link' =&gt; 'https://coffee-cms.com/modules/test/',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
84 'author' =&gt; 'Coffee CMS team',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
85 'version' =&gt; '20.04',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
86 'files' =&gt; array(
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
87 '.cms/mod/test.mod.php',
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
88 ),
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
89 'sort' =&gt; 100,
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
90 );</code></pre>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
91 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
92
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
93 <button data-copy=code>Копировать</button>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
94 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
95
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
96
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
97
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
98 <div class="block-code">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
99 <main data-example=wpic1>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
100 <p>Ниже пример картинки выходящей за ширину текста и описанием за счёт добавления класса wide тегу figure.</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
101
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
102 <figure class="wide">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
103 <img alt="" src="/mini/banner.jpg" width="1920" height="700">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
104 <figcaption>Описание изображения</figcaption>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
105 </figure>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
106 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
107
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
108 <button data-copy=wpic1>Копировать</button>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
109 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
110
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
111 <div class="block-code">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
112 <main data-example=wpic2>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
113 <p>Ниже пример картинки картинки выходящей за ширину текста за счёт добавления ей класса wide</p>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
114
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
115 <img class="wide" alt=""src="/mini/banner.jpg" width="1920" height="700">
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
116 </main>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
117
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
118 <button data-copy=wpic2>Копировать</button>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
119 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
120
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
121
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
122 <script>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
123 document.addEventListener( "DOMContentLoaded", function( event ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
124
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
125 document.querySelectorAll( "[data-copy]" ).forEach( function( button ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
126
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
127 button.addEventListener( "click", function( e ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
128
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
129 let html = document.querySelector( '[data-example="' + button.getAttribute( "data-copy" ) + '"]' ).innerHTML.trim();
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
130
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
131 let textarea = document.querySelector( "[data-for-copy]" );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
132 textarea.style = ""; // делаем видимым чтобы работало копирование
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
133 textarea.value = html;
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
134 textarea.select();
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
135 let ok = document.execCommand( "copy" );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
136
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
137 let old_text = button.textContent;
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
138 if ( ok ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
139 button.textContent = "OK";
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
140 setTimeout( function() {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
141 button.textContent = old_text;
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
142 }, 1000 );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
143 } else {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
144 button.textContent = "Ошибка";
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
145 setTimeout( function() {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
146 button.textContent = old_text;
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
147 }, 1000 );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
148 }
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
149 textarea.style.display = "none";
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
150
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
151 } );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
152
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
153 } );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
154
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
155 } );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
156
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
157 document.querySelectorAll( "img.lbox" ).forEach( function( img ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
158 img.addEventListener( "click", function () {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
159 if ( document.querySelector( "#lbox-window" ) == null ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
160 let img = document.createElement( "img" );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
161 img.src = this.getAttribute( "src" );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
162 let div = document.createElement( "div" );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
163 div.id = "lbox-window";
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
164 div.appendChild( img );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
165 document.body.appendChild( div );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
166 div.addEventListener( "click", function( e ) {
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
167 this.remove();
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
168 } );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
169 }
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
170 } );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
171 } );
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
172 </script>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
173
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
174 <div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
175 <textarea data-for-copy style="display: none;"></textarea>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
176 </div>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
177
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
178 </body>
Coffee CMS <info@coffee-cms.ru>
parents:
diff changeset
179 </html>