Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Создаёт статью про директиву @page #5620

Open
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

furtivite
Copy link
Member

@furtivite furtivite commented Jan 1, 2025

Описание

Написал статью про директиву @page

Closes #633

Превью: https://content-5620.dev.doka.guide/css/page/

Чек-лист

  • Текст оформлен согласно руководству по стилю
  • Ссылки на внутренние материалы начинаются со слеша и заканчиваются слэшем либо якорем на заголовок (/css/color/, /tools/json/, /tools/gulp/#kak-ponyat)
  • Ссылки на картинки, видео и демки относительные (images/example.png, demos/example/, ../demos/example/)

@furtivite furtivite self-assigned this Jan 1, 2025
@github-actions github-actions bot added css Контент по CSS дока Справочный материал labels Jan 1, 2025
@furtivite
Copy link
Member Author

localhost_8080_css_page_

@furtivite furtivite requested a review from vitya-ne January 2, 2025 08:00
Copy link
Member

@solarrust solarrust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Очень хорошая дока получилась, спасибо тебе!
Немного покомментировала.
Призываю @skorobaeus поревьюить демки.

css/page/demos/at-rules/index.html Outdated Show resolved Hide resolved
css/page/demos/at-rules/index.html Outdated Show resolved Hide resolved
css/page/demos/at-rules/index.html Outdated Show resolved Hide resolved
css/page/index.md Outdated Show resolved Hide resolved
css/page/index.md Outdated Show resolved Hide resolved
css/page/index.md Outdated Show resolved Hide resolved

У директивы `@page` есть правила для отступов на полях. Туда можно поместить номер страницы или название документа

<iframe title="Управление полями" src="demos/at-rules/" height="850"></iframe>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Было бы классно показывать как можно добавить номера страниц или другие стандартные элементы.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Там чуть выше пример, как раз описано, как добавить нолмер страницы, прям так и написано. А здесь в примере просто подсказка, какие поля задействуются.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Кроме номера страницы можно ещё что-то добавлять?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Можно добавлять любой текстовый контент.

css/page/index.md Outdated Show resolved Hide resolved
css/page/index.md Outdated Show resolved Hide resolved
css/page/index.md Show resolved Hide resolved
Copy link
Member

@Inventoris Inventoris left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Привет, информативная дока и очень классные демки получились)

Оставил несколько комментов.

P.S. Кстати, мб добавим простые адаптивы?


## Пример

Страница сайта будет напечатана на горизонтальном листе формата А4, у которой справа внизу указан номер листа:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Тут давай чуть поправим, потому что «страница» и её «у которой» очень далеко друг от друга стоят, и связка теряется.

Suggested change
Страница сайта будет напечатана на горизонтальном листе формата А4, у которой справа внизу указан номер листа:
Страница сайта напечатается на горизонтальном листе формата А4, у которого справа внизу будет номер:


ISO 216 легко узнать по буквам A, B или C в названии. Например, A4. Ещё эти размеры удобно делятся пополам. Например, половина A4 – это A5.

Ещё форматы на печати отличают по положению листа: горизонтальному и вертикальному.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Строчкой выше уже было «ещё», давай заменим на «также», если не сложно.

Suggested change
Ещё форматы на печати отличают по положению листа: горизонтальному и вертикальному.
Также форматы на печати отличают по положению листа: горизонтальному и вертикальному.

css/page/index.md Outdated Show resolved Hide resolved
transition: background-color 0.2s linear;
border: none;
border-radius: 1rem;
color: #181A1B;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Го добавим pointer при наведении:

Suggested change
color: #181A1B;
color: #181A1B;
cursor: pointer;

transition: background-color 0.2s linear;
border: none;
border-radius: 1rem;
color: #181A1B;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

И тут не помешает pointer :)

Suggested change
color: #181A1B;
color: #181A1B;
cursor: pointer;

css/page/demos/page-example/index.html Outdated Show resolved Hide resolved
css/page/demos/page-example/index.html Outdated Show resolved Hide resolved
css/page/demos/page-example/index.html Show resolved Hide resolved
css/page/demos/page-example/index.html Outdated Show resolved Hide resolved
css/page/demos/page-example/index.html Outdated Show resolved Hide resolved
Copy link
Member

@skorobaeus skorobaeus left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Привет! Это круто :) Давай сделаем очень круто!

Сейчас, когда в первом демо переключаешь опции, элементы управления прыгают по экрану и приходится гоняться за ними курсором:

Image from Gyazo

При этом справа есть много свободного места, которое никак не используется. Давай, пожалуйста, переместим элементы управления туда, а пример кода под них, чтобы ничего не "скакало":

image

Аналогичным образом предлагаю поправить и вторую демку. Там нет прыжков, но будет хорошо, если демки будут структурно похожи, то есть пользователь будет находить элементы управления в одном и том же месте.

И, конечно, в обе демки нужно добавить адаптив.

Copy link

Превью контента из bdf9b8b опубликовано.

@TatianaFokina
Copy link
Member

@furtivite, набежишь в пиар в ближайшее время?

@furtivite
Copy link
Member Author

Набегу. Но не обещаю, что прям сегодня

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
css Контент по CSS дока Справочный материал
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Директива @page
6 participants