Статьи

- Статьи

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

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

Как писать техническую документацию?

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

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

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

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

Качество технической документации. Часть I

Первая статья цикла, посвященного оценке качества техдокументации. Цикл статей будет полезен:

Качество технической документации. Часть IV - оценочные элементы удобства применения

Практические приемы оценки и повышения качества техдокументации по оценочным элементам фактора «удобство применения» согласно ГОСТ 28195-89. Материал входит в цикл статей «Качество технической документации». Редакция от 29.04.2021.

Качество технической документации. Часть V - оценочные элементы эффективности

Практические приемы оценки и повышения качества техдокументации по оценочным элементам фактора «эффективность» согласно ГОСТ 28195-89. Материал входит в цикл статей «Качество технической документации». Редакция от 29.04.2021.

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

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

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

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

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

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

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

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

Экспорт всех топиков предыдущего проекта с помощью Views

Экспорт всех топиков предыдущего проекта с помощью Views:

- Экспорт топиков - Title - Path (Content)

Настроить критерий фильтра: Content: Title:

- Настроить критерий фильтра - Content - Title

Должен содержать (, иначе экспортироваться будут ВООБЩЕ ВСЕ ТОПИКИ. Это как минимум. Если необходимо экспортировать все топики конкретного исходного предыдущего проекта, то тогда в поле Значение следует подставлять префикс этого проекта, например (_PREFIX_.

Интересно было бы еще экспортировать и поля Body, заполненные ранее участниками предыдущего проекта. Для этого во Views придется добавить Content: Body. Будет экспортирована полная HTML-разметка, но импорт с помощью CSV или даже XML может не прокатить из-за разметки, в связи с необходимостью конвертирования угловых скобок во всяческие gt и т.п. Вообще разумно экспортировать (сохранять) поля Body в отдельные файлы образцов.

Вопрос пока остается открытым и требует дополнительной проработки.

Импорт топиков последующего проекта с помощью CSV

Импорт топиков последующего проекта с помощью CSV без поля Body предусматривает создание нод типа topic для нового (последующего) проекта. Для этого _PREFIX_ меняется на новое значение (с учетом требований системы классификации и кодирования проектов). Затем выполняется импорт. Настройки импортера:

- Topic CSV Import (title и path)

Mappings Topic CSV Import (title и path):

- Mappings Topic CSV Import (title и path)

В результате импорта создаются отдельные ноды (сущности) нового проекта, но без какой-либо связки между собой.

Экспорт «консолидирующих» топиков предыдущего проекта с помощью Views

Экспорт топиков - Title - Path - Entity Embed (Content). Расширенные - Настройки запроса - Уникальность!

- Экспорт топиков - Title - Path - Entity Embed (Content)

Уникальность добавляется для того, чтобы не было дублирования. Для разделения списка внедренных топиков применен |.

Импорт «консолидирующих» топиков последующего проекта с помощью CSV

Импорт «консолидирующих» топиков последующего проекта с помощью CSV, настройки импортера:

- Редактировать CSV-импорт топиков (Title, Path, Entity Embed)

Mappings CSV-импорт топиков (Title, Path, Entity Embed):

- Mappings CSV-импорт топиков (Title, Path, Entity Embed)

Tamper CSV-импорт топиков (Title, Path, Entity Embed):

- Tamper CSV-импорт топиков (Title, Path, Entity Embed)

В плагине Explode в качестве разделителя применен |.

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

Страницы

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

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