Skip to content

Commit 69ffdd8

Browse files
committed
1 parent bde8731 commit 69ffdd8

File tree

4 files changed

+38
-44
lines changed

4 files changed

+38
-44
lines changed

‎docs/markup.txt‎

Lines changed: 31 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,55 @@
11
= Вёрстка =
22

3-
== #body-wrapper ==
4-
Обёртка для всего содержимого страницы, кроме подвала. Требуется для прилепливания подвала к низу страницы/окна браузера.
3+
Файлы шаблонов располагаются в корневой директории.
54

6-
: При полноценной поддержке CSS3 возможно обойтись без этого элемента.
5+
Файлы шаблонов сохранены в кодировке UTF-8 с использованием Unix-like разделителем строк.
76

7+
Ко всем внешним ресурсам (изображениям, стилям, скриптам) указаны относительные пути. Поэтому при подключении следует вносить соответствующие изменения.
88

9-
== #auth ==
10-
Строка информации о текущем пользователе.
9+
Во всех шаблонах повторяющиеся элементы должны быть полно��тью одинаковыми, но в качестве базового следует использовать default.html.
10+
Все изменения применяются и тестируются в первую очередь в этом документе.
11+
Он же является примером простой текстовой страницы и использования стандартых элементов (см. [[Elements]]).
1112

13+
Все исходники HTML имеют строгое форматирование.
14+
Если в HTML встречается вытянутый в одну строку блок кода, то это необходимость, связанная с некорректным восприятием white-spaces в браузере MSIE.
1215

13-
== #header ==
14-
Шапка страницы, содержит логотип и информацию о количестве каталогов, либо о количестве новых личных сообщений пользователя.
16+
== body-wrapper ==
17+
Обёртка для всего содержимого страницы, кроме подвала. Требуется для прилепливания подвала к низу страницы/окна браузера.
1518

16-
: Имеет фиксированные размер по высоте.
19+
: При полноценной поддержке CSS3 возможно отказаться этого элемента.
20+
21+
== auth ==
22+
Строка информации о текущем пользователе.
1723

24+
== header ==
25+
Шапка страницы, содержит логотип и информацию о количестве каталогов, либо о количестве новых личных сообщений пользователя.
1826

19-
== #navigation ==
20-
Блок навигации включает в себя списки меню первого и второго уровня, а также боковые декоративные блоки.
27+
: Имеет фиксированные размер по высоте.
2128

29+
== navigation ==
30+
Блок навигации включает в себя списки меню первого и второго уровня, а также боковые декоративные блоки.
2231

23-
== #content ==
24-
Основной блок с контентом страницы состоит из вспомогательного контейнера (.content-container), также может содержать заголовок страницы первого уроня (h1) и боковой блок (#sidebar).
32+
== content ==
33+
Основной блок с контентом страницы состоит из вспомогательного контейнера ([[#.content-container|.content-container]]), также может содержать заголовок страницы первого уроня (h1) и боковой блок ([[#sidebar|sidebar]]).
2534

2635
Все стили для оформление контента должны быть ограничены в пределах этого блока.
2736

28-
2937
== .content-container ==
30-
Вспомогатейльный контейнер для контента. Предназначен для разграничения непосредственно контента, заголовка страницы первого уровня и бокового блока.
31-
38+
Вспомогатейльный контейнер для контента. Предназначен для разграничения непосредственно контента, заголовка страницы первого уровня (h1) и бокового блока ([[#sidebar|sidebar]]).
3239

33-
== #sidebar ==
34-
Боковой блок фиксированной ширины. В большинстве шаблонов содержит список сайтов.
40+
: Блок является вспомогательным. При необходимости от этой дополнительной обёртки возможно отказаться.
3541

42+
== sidebar ==
43+
Боковой блок фиксированной ширины. Используется только в некоторых шаблонах. Как правило, применяется для блока списка сайтов пользователя.
3644

37-
== #footer-placeholder ==
38-
Пустой блок занимающий место #footer внутри #body-wrapper.
45+
== footer-placeholder ==
46+
Пустой блок занимающий место [[#footer|footer]] внутри [[#body-wrapper|body-wrapper]].
3947

40-
: Имеет фиксированный размер по высоте равный фактической высоте #footer.
48+
: При полноценной поддержке CSS3 возможно отказаться этого элемента.
4149

50+
: Имеет фиксированный размер по высоте равный фактической высоте [[#footer|footer]].
4251

43-
== #footer ==
44-
Подвал старницы содержит баннеры счётчиков, текст копирайта и вспомогательные ссылки навигации.
52+
== footer ==
53+
Подвал старницы содержит баннеры счётчиков, текст копирайта и вспомогательные ссылки навигации.
4554

4655
: Имеет фиксированный размер по высоте.
47-
48-

‎docs/readme.txt‎

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,11 @@
1-
Все текстовые файлы сохранены в кодировке UTF-8 с Unix разделителями строк.
2-
3-
4-
Все исходники HTML, CSS и JS аккуратно отформатированы. Если в HTML встречается вытянутый в одну строку блок кода, то это необходимость, связанная с некорректным восприятием white-spaces в IE.
5-
6-
7-
Во всех шаблонах повторяющиеся элементы должны быть одинаковыми, но в качестве базового следует использовать default.html. Все изменения применяются и тестируются в первую очередь в этом документе. Он же является примером простой текстовой страницы и использования стандартых элементов.
8-
9-
101
На главной странице используется несколько уникальных элементов оформления:
112
* страница состоит из "инфоблоков";
123
* два блока первого ряда имеют нетипичное оформление заголовков и текста;
134
* горизонтальная разделительная линия требует принципиально иной вёрстки центральной части страницы.
145
Соответствующие стили вынесены в index.css.
156

16-
177
Если "инфоблоки" потребуется использовать в других шаблонах, то рекоммендуется вынести соответствующие стили в infoblocks.css, который подключать по необходимости, либо в используемом во всех шаблонах blocks.css.
188

19-
209
Оформление элементов заголовков "инфоблоков" второго ряда главной страницы соответствует типичному оформлению заголовков первого уровня всех шаблонов.
2110

22-
2311
В ряде страниц имеется блок со списоком сайтов пользователя. Всё оформление этого блока вынесено в sitelist.css, который подключается по необходимости.

‎docs/scripts.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
В директории <code>libs</code> располагаются сторонние библиотеки.
55
В директории <code>forms</code> располагаются классы проверки и обработки форм.
66

7-
Файлы JavaScript-скриптов сохранены в кодировке UTF-8 с использованием Unix разделителем строк.
7+
Файлы JavaScript-скриптов сохранены в кодировке UTF-8 с использованием Unix-like разделителем строк.
88

99
== Структура ==
1010

‎docs/styles.txt‎

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
Файлы стилей располагаются в директории <code>/resources/styles/</code> от корня сайта.
44

5-
Файлы стилей сохранены в кодировке UTF-8 с использованием Unix разделителем строк.
5+
Файлы стилей сохранены в кодировке UTF-8 с использованием Unix-like разделителем строк.
66

7-
В стилях указаны относительные пути к изображениям. Поэтому при изменении расположения файлов стилей относительно файлов изображений следует внести соответствующие изменения.
7+
В стилях указаны относительные пути к изображениям. Поэтому при изменении расположения файлов стилей относительно файлов изображений следует вносить соответствующие изменения.
88

99
== Структура ==
1010
Таблицы стилей условно разделены на общие и дополнительные.
@@ -26,7 +26,7 @@
2626

2727
=== Дополнительные ===
2828
Дополнительными являются таблицы стилей, используемые только на определённых страницах и подключаемые только на этих страницах.
29-
Данные стили не имеют какого-либо иного логического разбиения.
29+
Данные стили не имеют какого-либо иного логического разбиения.
3030

3131
'''Список файлов дополнительных стилей:'''
3232
* catlist.css
@@ -71,13 +71,13 @@
7171
* <code>.fixed-width</code>
7272
* <code>.half-width</code>
7373
* <code>.onethird-width</code>
74-
Данные стили могут быть применены к любым block-level элементам, но рекомендуется использовать их только для <code>div</code>, <code>ul/ol</code> и <code>table</code>.
74+
Данные стили могут быть применены к любым block-level элементам, но рекомендуется использовать их только для <code>div</code>, <code>ul/ol</code> и <code>table</code>.
7575

7676
=== Прочее ===
7777
* <code>.cleaner</code>
7878
* <code>.cleaner-left</code>
7979
* <code>.cleaner-right</code>
80-
Данные стили могут быть применены к любым block-level элементам, но рекомендуется использовать их только для <code>div</code>, <code>ul/ol</code> и <code>table</code>.
80+
Данные стили могут быть применены к любым block-level элементам, но рекомендуется использовать их только для <code>div</code>, <code>ul/ol</code> и <code>table</code>.
8181

8282
=== Видимость ===
8383
* <code>.invisible</code>
@@ -97,7 +97,7 @@
9797

9898
* <code>tr.even</code>
9999
* <code>tr.odd</code>
100-
100+
101101
=== Формы ===
102102
* <code>form.brief</code>
103103

@@ -113,4 +113,3 @@
113113
* <code>.description</code>
114114
* <code>.message</code>
115115
* <code>.buttons</code>
116-

0 commit comments

Comments
 (0)