Статьи

- Статьи

В разделе НЕ структурированы, НЕ классифицированы и НЕ систематизированы полезные и интересные статьи, отвечающих на целый ряд животрепещущих вопросов. Аналитически все классифицировано и иерархически структурировано в блоке слева.

Имеется также гипертекстовая база терминов и определений из ГОСТов, позволяющая от «понятий» прийти к терминам (узаконить свои познания в части терминологии) и сделать каждое свое слово, произнесенное в ходе дискуссии с оппонентом, настоящим «приговором» - Ржунимагу! (смайл) Редакция от 24.08.2020.

Кастомные переменные в Drupal 8

Кастомные (в пользовательском контексте) переменные в Drupal 8 могут применяться для хранения и представления исходных (вводных) данных проекта, в состав которых входят наименование проекта, наименование продукта проекта, даты инициации и завершения проекта, заказчик, руководитель, куратор, все заинтересованные стороны, все участники проекта и многое-многое другое, в том числе параметры ссылок на внешние системы управления проектами (вроде Jira или Redmine).

Переменные могут существенно изменяться от проекта проекту, а могут и несущественно. Но в любом случае имеет смысл где-то их определить, зафиксировать документально и сохранить, а по мере необходимости вытаскивать на свет Божий и многократно повторно использовать в проектных документах. Все то же относится и к токенам. Редакция от 26.03.2021.

Клонирование сущностей через экспорт-импорт

Клонирование сущностей от проекта к проекту разумнее всего выполнять экспортом (безотносительно ГИС) предыдущего проекта с «последующим импортом последующего» 😂 Т.е. вновь создаваемого. Если, конечно, последующий проект представляется более-менее типовым.

А сущности в проектах применяются как простые, так и составные, т.е. консолидирующие все прочие, простые. Простая сущность - это топик, не содержащий в своей структуре внедренных топиков. Своего рода неспецифицированное изделие. Сложные же сущности содержат в своей структуре внедренные топики и являются изделиями специфицированными. Как книжки, состоящие из отдельных страниц.

Клонировать сущности имеет смысл в два этапа: экспортировать ВООБЩЕ ВСЕ топики, а затем их импортировать; экспортировать топики, содержащие внедренные топики, отдельно, а затем также отдельно их импортировать как консолидирующие. Для лучшего осмысления: сначала клонируем все поголовье, а затем отдельно особо выдающихся баранов, которые назначены нами козлами, ведущими свои субпоголовья.

Оба этапа проводятся с применением экспортеров на основе Views и импортеров на базе Feeds. Редакция от 22.03.2021.

Нетрадиционное применение модуля Entity Usage

Модуль Entity Usage интересен всем тем, кто однажды открыл его для себя и остался удовлетворен его потребительскими свойствами. Кто не знает - это такой модуль с пёсьей мордой, изображенной на рисунке ниже. Функционал модуля позволяет выявлять всевозможные связи между различными сущностями. Если совсем уж простым языком, то модуль Entity Usage отображает список материалов, в которых (многократно и повторно) используется картинка этой самой морды.

Представление (Views), упомянутое внизу страницы drupal.org/docs/8/modules/entity-usage/installation-and-basic-usage, позволяет вытащить число раз использования, т.е. число материалов (страниц и т.д.), содержащих связанную сущность. Но если подойти нетрадиционно (что нынче в тренде), то можно заполучить от модуля гораздо больше полезной информации. В частности, информацию о входимости некой сущности НЕ ПРОСТО В СОСТАВ других сущностей, а в КОНКРЕТНЫЕ УЗЛЫ ИЕРАРХИЧЕСКИХ СТРУКТУР этих сущностей. С прямым попаданием в них. Редакция от 20.03.2021.

Drupal Entity Usage

Бессовестно вольный перевод с комментариями, первоисточник drupal.org/project/entity_usage. Модуль Entity Usage был весьма ожидаем (автором), но впервые упомянут только в июле 2016 года, т.е. с запозданием примерно в 15 лет по отношению к «десктоповому варианту» соответствующей фунциональной возможности программы AuthorIT. Редакция от 19.03.2021.

Модуль Drupal 7 HTML import. Сокращенный перевод с комментариями

Любопытный модуль Drupal 7 HTML import. Если хорошо структурированный стилями заголовков документ ворда сохранить в формате HTML, а затем хорошенько почистить с помощью Dreamweaver, то можно получить ноды из заголовков.

Сокращенный перевод описания, комментарии после развертывания, настройки и проверки работоспособности. Редакция от 04.04.2021.

Сущности Drupal без полей

Цитата из русского перевода руководства пользователя Drupal:

«В пределах сущности, данные хранятся как отдельные поля, каждое из которых содержит один тип данных, такие как форматированный или обычный текст, изображения или другие файлы или даты. Типы полей могут быть определены через ядро Drupal или модули.

Поля могут быть добавлены администратором для подтипа сущности, так что все сущности этого подтипа имеют одинаковый набор доступных полей. Например, Продавец тип материала на сайте городской ярмарки может иметь поля для Имя продавца, логотипа, URL сайта и описания, в то время как Основная страница тип материала может иметь только поля для заголовка и текста. Когда вы создаете или редактируете сущности, вы определяете значения для полей в сущности».

Всегда ли сущностям Drupal необходимы поля? Возможно ли обойтись без полей, как обойтись без полей и что это даст? Редакция от 14.03.2021.

Клонирование матрицы путем многократного повторного использования контента

Клонирование матрицы путем многократного повторного использования контента (reusing) - вовсе не преступление против т.н. «человечности» (какой идиот выдумал это словечко?!), а напротив - отличный технологический прием, работающий во благо и во имя всего прогрессивного человечества. Клонирование применяется к онлайновым библиотекам взаимоувязанных документов.

Суть проблемы: путь в матрицу, подробно расписанный в предыдущей статье, позволяет создавать всего лишь один «экземпляр класса», - библиотеки взаимоувязанных документов. Но экземпляров библиотек может потребоваться великое множество. Разумеется, все ожидаемые издержки на их клонирование должны быть сведены к минимуму. Редакция от 12.03.2021.

Путь в матрицу

Путь в матрицу

Библиотека взаимоувязанных документов, привязанная к отечественным стандартам разработки, проектирования и документирования, выполненная в многопользовательском глобально-сетевом варианте. В качестве движка применяется Drupal с минимально необходимым числом «контрибных» модулей и модулей ядра. Почти никакого программирования. Последовательность действий при подготовке и импорте контента в Drupal для организации нод, «портирование» ранее созданной и обкатанной библиотеки. Редакция от 15.12.2020.

Библиотеки взаимоувязанных документов при обратной разработке (reverse engineering)

Библиотеки взаимоувязанных документов представляют особый интерес при обратной разработке. И не только - библиотеки взаимоувязанных документов позволяют документировать с самых различных «точек входа», с любой стадии или этапа жизненного цикла.

Обратимся ко всеми любимой педевикии, поскольку стандарты всегда несколько отстают от образования некоторой сущности или «новой формулы». Итак, «Обратная разработка (обратный инжиниринг, реверс-инжиниринг; англ. reverse engineering) - исследование некоторого изделия или программы, а также документации на него с целью понять принцип его работы и, чаще всего, воспроизвести устройство, программу или иной объект с аналогичными функциями, но без копирования как такового.». И начнем воспроизводить. Редакция от 13.03.2021.

3.6.1 Поиск путей повышения качества выпускаемой технической документации (F/01.7)

3.6.1 Поиск путей повышения качества выпускаемой технической документации (F/01.7)

3.6.1 Поиск путей повышения качества выпускаемой технической документации (F/01.7) - трудовая функция, присвоенная профессиональным стандартом гражданам, квалификация которых позволяет занимать должности программиста, занятого программированием, и (или) инженера, профессионально занимающегося инженерным делом в части документирования. Более того, требуется практический опыт работы программистом или опыт программирования для собственных нужд (научных, личных или иных), опыт участия в разработке и сопровождении крупных комплектов технической документации в качестве технического писателя. Редакция от 28.10.2020.

Страницы

Copyright © «Техническая документация» 2008-2021. Заимствуйте наши материалы с блеском! При воспроизведении материалов портала обязательна установка активной гиперссылки на источник — страницу с этой публикацией на tdocs.su.

Яндекс.Метрика