Доброе понедельничное ☀️

Дабы оно стало еще чутка добрее, вот вам мем: инструкция по жарке яичницы от ChatGPT.

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

А самое главное — приятно встречать еще одного коллегу-бывшего переводчика в техписательском ремесле! 🏆

https://habr.com/ru/companies/X5Tech/articles/866312/

Кстати, этот мем за меня сделал ИИ 🙂

А если у вас тоже есть вопросик, но вы по каким-то причинам не хотите задавать его лично, присылайте его по ссылочке ниже – я обязательно отвечу. Не обещаю, что моментально, но ответ в любом случае дам 😀

«Я просто спросить»

P.S: А если вам удобнее старый метод отправки вопроса, то вот ссылочка на гугл-форму

Привет!

Какой хороший воскресный день, чтобы опубликовать новый урок по DITA, и вот, собственно, он опубликован :)

Сегодня у нас небольшой «технический» урок, на котором мы настроим все, что нужно для работы с DITA (по крайней мере, в рамках этого курса). Короче говоря:
1. Мы установим редактор Oxygen XML Editor и активируем пробную лицензию.
2. После этого мы ~~костылизируем~~ кастомизируем вид редактора.
3. И напоследок: создадим много всяких папок.
Итак, к делу 🏃‍♂️

Установка и активация Oxygen XML Editor
Чтобы установить Oxygen XML Editor, выполните следующие действия:
1️⃣ Перейдите по ссылке для скачивания программы, выберите вариант установки (для Windows, macOS или другое) и нажмите Download. Далее начнется скачивание установочного файла.
2️⃣ Пока скачивается файл, необходимо заполучить ключ для активации Oxygen. Вообще ключ активации платный, но для нашего курса вполне достаточно будет ключа для активации 30-дневной пробной версии Oxygen.

‼️ Чтобы заполучить ключик, заполните данные в форме Obtain free trial as a guest: email, на который придет ключ для активации, свое имя, название компании (можете ввести Freelance), страну, тип лицензии (достаточно Enterprise).

3️⃣ После ввода всех данных нажмите кнопку Submit, после чего на электронную почту, которую вы указали, придет ключ для активации Oxygen. Выглядит он примерно так:

\-\-\-\-\-\-START\-LICENSE\-KEY\-\-\-\-\-\- много рандомных букв \-\-\-\-\-\-\-END\-LICENSE\-KEY\-\-\-\-\-\-\-

4️⃣ Скопируйте ключ из письма.
5️⃣ Запустите Oxygen XML Editor, в открывшемся окне вставьте ранее скопированный ключ и нажмите ОК.
6️⃣ Программа запустилась, вы восхитительны!

Кастомизация
При первом запуске Oxygen будут отображаться не все нужные нам панели, поэтому нам потребуется добавить их. Панель добавить очень просто — нужно перейти во вкладку меню Window → Show View и выбрать необходимую панель, которая будет отображаться в левой или правой части редактора.

Панелей много и на любой, как говорится, вкус, но нам в рамках курса пригодятся только следующие:
🔵DITA Maps Manager — панель, в которой отображаются наши открытые карты;
🔵Project — панель со структурой нашего проекта;
🔵DITA Reusable Components — панель поиска терминов и реюзов;
🔵Transformation Scenarios — панель сценариев трансформации.

Папки
~~На посошок~~ Напоследок давайте создадим папки для хранения нашего проекта:
1️⃣ Создайте корневую папку на рабочем столе вашего ПК и придумайте ей название (например, «Курс DITA»).
2️⃣ В корневой папке создайте следующие папки:
🔴glossary — здесь мы будем хранить термины, используемые в документации;
🔴images — сюда положим изображения из документации;
🔴output — в эту папку будет выгружаться готовая документация;
🔴reusable — в этой папке будут храниться реюзы;
🔴topics — а в этой папке будут «отдыхать» топики.
3️⃣ ...
4️⃣ PROFIT

Ну, в общем-то и все, на сегодня достаточно — воскресенье все-таки 😁

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

Поэтому, stay tuned! 😏

#dita

Штош, кворум набрался, поэтому голосование по рассказу о CodeFest считаем состоявшимся. Те, кто не хочет читать — пролистывайте этот пост со спокойной душой, а желающие почитать — устраивайтесь поудобнее, поехали :)

Все началось с того, что я чисто случайно наткнулся на сообщение Тани Фокиной в желтом чате. Звучало оно примерно так: «Ищу техписателя, который в работе или вне работы балуется нейросетями и сможет прийти поболтать на квартирнике в Новосибирске».

После тщательных размышлений и взвешивания всех «за» и «против», я написал Тане, согласовал свое участие и 27 мая доехал на бесплатном автобусе до Экспоцентра.

Первое, что меня приятно удивило — это размах и масштаб конференции. И самое важное — проводится она не где-нибудь в условной Москве, а в городе, где я живу ?

Правда, придя туда, я ощутил себя маленькой рыбкой-клоуном среди акул отечественного IT. Наверняка, это чувство связано с тем, что я в тот момент был новичком в новой профессии (хотя, как будто сейчас что-то изменилось, ага).

Кроме того, я сильно нервничал. Прямо очень. В попытках снизить уровень нервозности я метался от докладов к спонсорским стендам, оттуда — в зону кофе-брейка, чтобы влить в себя очередные пол-литра кофе, не забывая пообщаться с другими участниками.

Ситуацию немного улучшали призовые стикеры, носки и печеньки, которые я получал за участие в активностях, но полностью расслабиться, увы, не удавалось. Мой мозг забивала только одна мысль: «ЧТО ЖЕ ТАКОЕ ЭТОТ ВАШ КВАРТИРНИК, БЛИН, И О ЧЕМ МНЕ ТАМ ПРИДЕТСЯ ГОВОРИТЬ?»

Как человек, который ранее не присутствовал на таких мероприятиях, мое понимание термина «квартирник» ограничивалось только этим: «НУ, ЭТО ГДЕ ПЕСНИ ПОД ГИТАРУ ПОЮТ, ЫЫЫ». Однако это суждение никак не коррелировало с форматом конференции, и я предположил, что «квартирник» — это некий эвфемизм к термину «круглый стол».

Спойлер: я был прав.

К слову, квартирник был посвящен до боли актуальному вопросу: «Заменят ли нас нейросети?»

Если говорить о самом выступлении, то я его плохо помню и не особо люблю вспоминать. Собственное волнение мне только мешало — я путался, запинался, нелепо шутил и каламбурил, и у меня жутко кружилась голова.

Как итог — что тогда, что год спустя я остался и остаюсь очень недоволен своим выступлением. Несмотря на то, что на тот момент я уже активно «баловался» нейросетями и понимал, о чем идет речь. Несмотря на лояльность публики и отсутствие троллинга.

Зато, по крайней мере, я поучаствовал бесплатно в CodeFest-е, и этот опыт стал подспорьем для моего дальнейшего участия в TechWriters Days в этом году ?

Видеозапись квартирника оставляю здесь, кринжуйте на здоровье :D

Теперь — история про поедание торта с пола, или послесловие.
Вышли мы с ребятами из зала и двинули на after party, предвкушая большой дастархан с тортом и алкоголем.

Вдруг, под музыку из капитал-шоу «Поле чудес» и вопли Я(Мы)кубовича двое парней внесли в зал торт немаленьких размеров и… как бы невзначай уронили его на пол. В итоге: торт всмятку, парни в печали.

Подоспевшие зеваки начали фотографировать то, что пару минут назад было тортом. Я и еще несколько отчаянных подошли к этой куче поближе. В мгновение ока я (как и другие собравшиеся) подумал: «А что, если…?»

Я зачерпнул немного торта, который возвышался над полом, и попробовал.

Поняв, что он вполне съедобный и даже вкусный, я дал понять остальным, что торт вполне съедобен и даже вкусен. И хорошо, что я успел набить им доверху свою термокружку, потому как в считанные минуты его раздербанили на атомы и молекулы :D

Наверняка, со стороны я смотрелся еще кринжовее, чем на квартирнике, но я ни о чем не жалею)))