gaspersic/free-programming-books
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

chore: HTML5 anchors compilant <a name= > <a id= (#6730)

Browse Source 
* HTML5 anchors compilant `<a name=>` > `<a id=` for books

* HTML5 anchors compilant `<a name=>` > `<a id=` for courses

* HTML5 anchors compilant `<a name=>` > `<a id=` for contribs

* HTML5 anchors compilant `<a name=>` > `<a id=` for casts

* HTML5 anchors compilant `<a name=>` > `<a id=` for cheats

* HTML5 anchors compilant `<a name=>` > `<a id=` for interactives

* HTML5 anchors compilant `<a name=>` > `<a id=` for playgrounds
This commit is contained in:
David Ordás
2022-02-25 17:23:35 +01:00
committed by GitHub
parent 47bc198769
commit 0e9ad7e994
60 changed files with 140 additions and 143 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
docs/CONTRIBUTING-ru.md
View File

@ -1,19 +1,19 @@
*[Доступно на других языках](README.md#
<!----><a name="contributor-license-agreement"></a>
<!----><a id="contributor-license-agreement"></a>
## Лицензионное соглашение с участником
Принимая участие, вы соглашаетесь с [ЛИЦЕНЗИЕЙ](../LICENSE) этого репозитория.
<!----><a name="contributor-code-of-conduct"></a>
<!----><a id="contributor-code-of-conduct"></a>
## Кодекс поведения автора
Принимая участие, вы соглашаетесь соблюдать [Кодекс поведения](CODE_OF_CONDUCT-ru.md) этого репозитория. ([translations](README.md#
<!----><a name="in-a-nutshell"></a>
<!----><a id="in-a-nutshell"></a>
## В двух словах
1. «Ссылка для легкой загрузки книги» не всегда является ссылкой на *бесплатную* книгу. Пожалуйста, размещайте только бесплатный контент. Убедитесь, что это бесплатно. Мы не принимаем ссылки на страницы, которым *требуются* адреса электронной почты на рабочем домене для получения книг. Однако мы приветствуем списки, которые запрашивают их.
@ -34,7 +34,7 @@
5. GitHub Actions запустит тесты, чтобы убедиться, что ваши **списки отсортированы по алфавиту** и **соблюдаются правила форматирования**. **Обязательно проверьте**, чтобы ваши изменения прошли проверку.
<!----><a name="guidelines"></a>
<!----><a id="guidelines"></a>
### Руководство
- Убедитесь что книга бесплатна. При необходимости проверьте еще раз. Администраторам помогает, если вы описываете в PR, почему вы думаете, что книга бесплатная.
@ -62,7 +62,7 @@
- если перед загрузкой запрашивается адрес электронной почты или настройка учетной записи, добавьте в скобки примечания на соответствующем языке, например: `(адрес электронной почты *запрашивают*, но он не требуется для загрузки)`.
<!----><a name="formatting"></a>
<!----><a id="formatting"></a>
### Форматирование
- Все списки представляют собой файлы с расширением `.md`. Попробуйте изучить синтаксис [Markdown](https://guides.github.com/features/mastering-markdown/). Это просто!
@ -132,33 +132,33 @@
ХОРОШО: * [Очень хорошая книга (1970)](https://example.org/book.html) - Джейн Роу
```
- <a name="in_process"></a>Незавершенные книги:
- <a id="in_process"></a>Незавершенные книги:
```text
ХОРОШО: * [Скоро будет отличная книга](http://example.com/book2.html) - Джон Доу (HTML) (:construction: *in process*)
```
<!----><a name="notes"></a>
<!----><a id="notes"></a>
### Примечания
Хотя основы относительно просты, перечисленные нами ресурсы очень разнообразны. Вот несколько замечаний о том, как мы справляемся с этим разнообразием.
<!----><a name="metadata"></a>
<!----><a id="metadata"></a>
#### Метаданные
Наши списки предоставляют минимальный набор метаданных: заголовки, URL-адреса, создателей, платформы и примечания к доступу.
<!----><a name="titles"></a>
<!----><a id="titles"></a>
##### Заголовки
- Никаких вымышленных названий. Мы стараемся брать названия с самих ресурсов; призываем авторов пулреквестов не придумывать заголовки и не использовать их в редакционных целях, если этого можно избежать. Исключение составляют более старые работы; если они представляют в первую очередь исторический интерес, год в скобках, добавленный к названию, помогает пользователям узнать, представляют ли они интерес.
- Избегайте заголовков ПОЛНОСТЬЮ ЗАГЛАВНЫМИ БУКВАМИ. Обычно уместен регистр заголовка, но в случае сомнений используйте заглавные буквы из источника.
<!----><a name="urls"></a>
<!----><a id="urls"></a>
##### URLs
- Мы не разрешаем сокращенные URL-адреса.
@ -168,7 +168,7 @@
- Нам не нравятся URL-адреса, которые указывают на страницы со ссылкой на другое место вместо указанного ресурса.
<!----><a name="creators"></a>
<!----><a id="creators"></a>
##### Creators
- Хотим поблагодарить создателей бесплатных ресурсов, где это возможно, в том числе переводчиков!
@ -177,7 +177,7 @@
- Для подборок и смешенных изданий «создателю» может потребоваться описание. Например, книги «GoalKicker» считаются «`Скомпилированными из документации StackOverflow`» ("на английском: «`Compiled from StackOverflow documentation`»).
<!----><a name="platforms-and-access-notes"></a>
<!----><a id="platforms-and-access-notes"></a>
##### Платформы и примечания к доступу
- Курсы. Платформа является важной частью описания ресурсов, особенно для наших списков курсов. Это связано с тем, что платформы курсов имеют разные возможности и модели доступа. Хотя мы обычно не перечисляем книги, требующие регистрации, на многих платформах курсов есть возможности, которые не работают без какой-либо учетной записи. Например, как на Coursera, EdX, Udacity и Udemy. Если курс зависит от платформы, название платформы должно быть указано в скобках.
@ -186,13 +186,13 @@
- Leanpub. Leanpub размещает книги с различными моделями доступа. Иногда книгу можно прочитать без регистрации; иногда для бесплатного доступа к книге требуется учетная запись Leanpub. Учитывая качество книг, а также сочетание и гибкость моделей доступа к Leanpub, мы разрешаем перечисление последних с указанием доступа `*(требуется учетная запись Leanpub или действующий адрес электронной почты)*`.
<!----><a name="genres"></a>
<!----><a id="genres"></a>
#### Жанры
Первое правило при принятии решения, к какому списку принадлежит ресурс, — это посмотреть, как ресурс описывает себя. Если он называет себя книгой, то, возможно, это книга.
<!----><a name="genres-we-dont-list"></a>
<!----><a id="genres-we-dont-list"></a>
##### Жанры, которые мы не вносим в списки
Поскольку Интернет огромен, мы не включаем в наши списки:
@ -210,7 +210,7 @@
В наших списках соревновательного программирования эти исключения не так строги. Объем репо определяется сообществом; если вы хотите предложить изменение или дополнение к области, пожалуйста, используйте Issue, чтобы сделать предложение.
<!----><a name="books-vs-other-stuff"></a>
<!----><a id="books-vs-other-stuff"></a>
##### Книги против прочих ресурсов
Мы не так привередливы в "книжности" ресурса. Вот некоторые атрибуты, которые указывают на то, что ресурс - это книга:
@ -226,7 +226,7 @@
Мы перечисляем множество книг, у которых нет этих атрибутов; это может зависеть от контекста.
<!----><a name="books-vs-courses"></a>
<!----><a id="books-vs-courses"></a>
##### Книги против курсов
Иногда их бывает трудно отличить!
@ -234,13 +234,13 @@
С курсами часто связаны учебники, которые мы перечисляем в наших списках книг. В курсах есть лекции, упражнения, тесты, заметки или другие дидактические пособия. Отдельная лекция или видео - это не курс. PowerPoint - это не курс.
<!----><a name="interactive-tutorials-vs-other-stuff"></a>
<!----><a id="interactive-tutorials-vs-other-stuff"></a>
##### Интерактивные учебники и другие материалы
Если вы можете распечатать его и сохранить его суть, это не интерактивное руководство.
<!----><a name="automation"></a>
<!----><a id="automation"></a>
### Автоматизация
- Применение правил форматирования автоматизировано с помощью [GitHub Actions](https://github.com/features/actions) с использованием [fpb-lint](https://github.com/vhf/free-programming-books-lint) (см. [`.github/workflows/fpb-lint.yml`](../.github/workflows/fpb-lint.yml))