Общие значения для разных заметок

Ставки, цены и часто используемые формулы удобно хранить в одном месте. Запишите их в заметку, а в других подключайте одной строкой. Изменение источника дойдёт до всех заметок, которые его используют.

Используйте значения другой заметки

В блоке вычислений на отдельной строке напишите use и ссылку на заметку:

calcРезультаты зависят от сегодняшней даты или актуальных данныхКопировать

use [[Assumptions]] даёт 2 values and 1 function from Assumptions

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

calcРезультаты зависят от сегодняшней даты или актуальных данныхКопировать

use [[Assumptions]] даёт 2 values and 1 function from Assumptions

margin($80) даёт $100.00

$100 * rate даёт $108.00

если заметка Assumptions содержит:

calcКопировать

rate = 1.08 даёт 1.08

markup = 25% даёт 25%

margin(cost) = cost + markup даёт

Импортированные имена доступны во всей использующей их заметке, а не только ниже строки use. Собственное определение имени в заметке имеет приоритет начиная со строки определения.

Берите только те имена, которые вам нужны

Перечислите имена перед from, чтобы выбрать только те:

calcРезультаты зависят от сегодняшней даты или актуальных данныхКопировать

use margin, rate from [[Assumptions]] даёт margin, rate from Assumptions, with markup that it reads

Тогда другие имена источника, например определённое в нём total, не смогут подменить значения этой заметки. Разделяйте имена запятыми; пробелы внутри имени допустимы (use monthly rent, fee from [[Budget]]). Функция импортируется вместе с используемыми ею значениями и даёт тот же результат, что в исходной заметке. Строка поясняет, какие значения перенесены.

Имя, которое источник не определяет, после опечатки или после переименования, является ошибкой, и ничего не импортируется:

calcРезультаты зависят от сегодняшней даты или актуальных данныхКопировать

use margn from [[Assumptions]] даёт Error: No value or function named “margn” in Assumptions

Запись строки

• use может быть написано с заглавной буквы ( Use [[Rates 2026]] ), и за ним может следовать комментарий // или # .
• Ничто другое не может разделять строку: use [[Assumptions]] * 2 не является импортом.
• Строка должна находиться внутри блока вычислений. В обычном тексте она остаётся текстом.
• Исходная заметка тоже может подключать другую; допускается цепочка глубиной до восьми заметок.

Когда источник недоступен

Импорт никогда не оставляет старое число на месте. Если источник не может быть прочитан, строка говорит об этом, а имена остаются неопределенными:

Переименование и обновление значений

При переименовании исходной заметки Varlig обновляет ведущие к ней строки use. Открытая заметка пересчитывается при изменении источника. При каждом открытии заметка заново читает свои источники.

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

Всплывающее окно объяснения показывает, откуда пришло импортированное имя, например, rate = 1.08 (from Assumptions) поэтому вы всегда можете отличить локальное значение от общего значения.

Чтобы перед изменением значения узнать зависимости, откройте исходную заметку. Пояснение How Was This Read? у строки с определением значения или функции содержит Used by 2 Notes и названия использующих заметок, например Invoice (uses every value). Раздел Backlinks источника начинается с Used in calculations by 2 notes и показывает, что импортирует каждая заметка. Строки use не считаются обычными обратными ссылками.