Написання клінічних текстів і грантових заявок: приватність, відстежувані чернетки та LaTeX офлайн

Чому медичним авторам, фахівцям із громадського здоров’я та авторам грантових заявок важливо, де зберігається чернетка, і як локальний дослідницький редактор зі справжнім Git, офлайн-компіляцією та без облікового запису вписується в цикли рецензування.

Клінічні рукописи та описові частини грантових заявок часто містять чутливі подробиці ще до завершення деідентифікації. Віддати кожне натискання клавіші редактору стороннього постачальника — це так само рішення щодо політики, як і вибір інструментів. Етичні комітети (IRB), угоди про використання даних та ІТ-відділи лікарень не зважають на те, що хмарний редактор об 11 вечора був зручним.

Цей допис про те, як писати чернетки та верстати так, щоб це можна було пояснити службі комплаєнсу. Сприймайте його як пораду щодо робочого процесу, а не як юридичну експертизу.

Звичайні файли простіше аналізувати

Папка з файлами .tex і рисунками може лежати на зашифрованому диску, в образі лікарняного ноутбука або на ізольованій від мережі (air-gapped) машині. Службі комплаєнсу можна вказати конкретний шлях. Проєкти в браузері вимагають довіряти моделі доступу постачальника, шляху експорту та переліку субобробників даних.

Oleafly (відкривається в новій вкладці) навмисно створено саме таким: без облікового запису, без телеметрії продукту, проєкти як звичайні папки зі справжнім репозиторієм Git. Сторінка про приватність коротка, бо для існування документа сервер Oleafly не потрібен. Мережа потрібна для дій, які ви запускаєте самі (пакети, необов’язковий пошук цитувань, хмарний ШІ, якщо ви його ввімкнули, GitHub), а не для кожного натискання клавіші в чернетці.

Якщо політика забороняє хмарний ШІ, залиште асистента вимкненим або підключіть локальну модель. Редактор, цикл компіляції та Git усе одно працюють.

Відстежуйте зміни, не живучи у Word

Керівники грантових проєктів (PI) досі просять «відстеження змін». У світі LaTeX це зазвичай означає історію Git плюс коментарі співавторів у PDF або короткий експорт у Word для того, хто відмовляється щось встановлювати. Тримайте .tex як джерело істини (докладніше: співавтори, які користуються лише Word).

В Oleafly кожен проєкт від першого дня є репозиторієм Git: автоматичні контрольні точки після успішних компіляцій і пауз у редагуванні, порівняння змін поруч, відновлення в один клік, необов’язковий GitHub, якщо вам потрібен приватний віддалений репозиторій. Можна відгалузити весь пакет заявки в другий проєкт (з повною історією), щоб спробувати ризиковане скорочення, не торкаючись копії для подання. Якщо ви користуєтеся необов’язковим асистентом зі ШІ, він робить контрольну точку перед першою правкою і вносить зміни лише після схвалення у вікні порівняння.

Називайте коміти за цілями чи розділами (aim2-methods-cut), щоб PI міг переглянути історію, не читаючи порівняння змін, як інженер-програміст.

Офлайн корисний у лікарнях

Клінічні мережі блокують довільні домени SaaS. Локальний компілятор дає змогу писати між сеансами роботи з електронною медичною карткою (EHR). Oleafly постачає Tectonic (і Typst) у складі застосунку; пакети кешуються після першого використання, а в офлайн-режимі компілятору можна заборонити доступ до мережі. Перевірка орфографії та граматики працює локально на тексті (команди й математика пропускаються). Саме такі обмеження зазвичай хвилюють ІТ-відділи лікарень, тому локальні дослідницькі редактори згадують часто.

SyncTeX і PDF поруч із вихідним кодом важливі, коли ви підганяєте текст під ліміт сторінок на комп’ютері сестринського поста з нестабільним Wi‑Fi.

Шаблони, ліміти сторінок і передперевірка

Шаблони у стилі NIH та фондів — це поля, шрифти та обмеження за кількістю сторінок. Пакети для геометрії сторінки та шрифтів важливіші за хитрі макроси. Компілюйте в PDF і перевіряйте кількість сторінок після кожного великого скорочення, а не напередодні закриття порталу. Починайте з відомого шаблону з галереї, якщо такий підходить; усе одно звіряйте шрифти, поля й структуру з актуальним FOA (Specific Aims на одну сторінку означає рівно одну сторінку).

Коли PDF має пройти через машинне читання (резюме, деякі інституційні портали), «Передперевірка» показує структуру та результати вилучення тексту, подібного до роботи парсера, ще до подання. Це евристичні сигнали ризику, які можна прочитати й на які можна відреагувати.

Співпраця кількох PI

Закріплюйте файли за відповідальними за розділами чи цілями. Одна людина відповідає за головний .bib або спільний експорт групи Zotero. Домовтеся, чи співавтори редагують TeX, чи повертають коментарі в PDF. Приватні віддалені репозиторії лише на схвалених інституційних хостах Git, якщо цього вимагає політика; не кожна чернетка гранту має бути на публічному GitHub.

Менеджери бібліографії

Спільні групи Zotero експортують .bib, який можуть оновлювати кілька PI. Імпортуйте його в проєкт, вставляйте DOI, коли додаєте нові цитування, і перевіряйте відсутні поля перед поданням, щоб замість років у зібраному PDF не з’являлося [?]: перевірка BibTeX. Oleafly доповнює й перевіряє ключі цитувань за бібліографією проєкту, поки ви пишете, тож зламані ключі \cite видно ще до того, як про них скаже журнал.

Рисунки та PHI

Ніколи не поміщайте дані пацієнтів, за якими можна ідентифікувати особу, у рисунки чи підписи, призначені для репозиторію, який інші можуть клонувати. Користуйтеся деідентифікованими схемами. Усе, що лишається чутливим, зберігайте з тими самими засобами контролю, що й клінічний набір даних, а не поруч із публічною схемою методів.

Чим це не є

Local-first усе одно підпадає під перегляд IRB, угоди про використання даних і деідентифікацію. Якщо ввімкнути хмарний ШІ або надіслати зміни у віддалений репозиторій, частина байтів залишить комп’ютер на умовах політик цих сервісів. Local-first змінює типовий шлях для написання чернетки чутливого тексту: папка, яку ви контролюєте, редактор, що працює офлайн, та історія, яку можна відновити, не просячи в постачальника експорту.

Практичне початкове налаштування

  1. Створіть локальний проєкт; увімкніть офлайн-компіляцію, щойно пакети закешовано.
  2. Не вмикайте ШІ, доки політика й команда не погодять постачальника.
  3. Приватний віддалений репозиторій лише на схваленому хості.
  4. Власник кожного розділу та єдиний власник бібліографії.
  5. Перевірка кількості сторінок після кожного великого скорочення цілей і дослідницької стратегії.

Пишіть так, ніби офіцер із комплаєнсу запитає, де жила чернетка. Якщо відповідь «папка на зашифрованому ноутбуці, історія Git локальна, за потреби приватний віддалений репозиторій», ви в кращому становищі, ніж із відповіддю «обліковий запис на сервісі, який ми ніколи не перевіряли».

Всі пости