Przejdź do treści
Przewodnik po Varlig
Strona główna Varlig

Wspólne wartości między notatkami

Stawki, ceny i wzory, na których polegasz, najlepiej trzymać w jednym miejscu. Umieść je w notatce, a inne notatki mogą pobierać je jednym wierszem. Zmiana źródła dociera wtedy do wszystkich korzystających z niego notatek.

Korzystanie z wartości innej notatki

W bloku obliczeniowym wpisz w osobnym wierszu use i odsyłacz do notatki:

calcWyniki zależą od dzisiejszej daty lub aktualnych danych
use [[Assumptions]] daje 2 values and 1 function from Assumptions

Wynik podaje, co zaimportowano. Od tej chwili nazwy z drugiej notatki działają tak, jakby zdefiniowano je tutaj:

calcWyniki zależą od dzisiejszej daty lub aktualnych danych
use [[Assumptions]] daje 2 values and 1 function from Assumptions
margin($80) daje $100.00
$100 * rate daje $108.00

przy notatce Assumptions zawierającej:

calc
rate = 1.08 daje 1.08
markup = 25% daje 25%
margin(cost) = cost + markup daje

Importowane nazwy są dostępne w całej notatce docelowej, nie tylko pod wierszem use. Własna definicja notatki ma pierwszeństwo od wiersza, w którym się pojawia.

Importowanie tylko potrzebnych nazw

Wymień nazwy przed from, aby pobrać tylko je:

calcWyniki zależą od dzisiejszej daty lub aktualnych danych
use margin, rate from [[Assumptions]] daje margin, rate from Assumptions, with markup that it reads

Pozostałe nazwy źródła, na przykład zdefiniowane tam total, nie zastąpią wtedy własnych nazw tej notatki. Oddzielaj nazwy przecinkami; mogą zawierać spacje (use monthly rent, fee from [[Budget]]). Funkcja dołącza wartości, z których korzysta, aby dawać taki sam wynik jak w źródle, a wiersz podaje, które wartości pobrano.

Nazwa niezdefiniowana w źródle, na przykład wskutek literówki lub zmiany nazwy, daje błąd i nic nie zostaje zaimportowane:

calcWyniki zależą od dzisiejszej daty lub aktualnych danych
use margn from [[Assumptions]] daje Error: No value or function named “margn” in Assumptions

Zapis wiersza

  • use może zaczynać się wielką literą (Use [[Rates 2026]]), a po nim może być komentarz // lub # .
  • Nic innego nie może być w tym wierszu: use [[Assumptions]] * 2 nie jest importem.
  • Wiersz musi znajdować się w bloku obliczeniowym. W prozie pozostaje zwykłym tekstem.
  • Notatka źródłowa może korzystać z trzeciej notatki, do ośmiu poziomów głębokości.

Gdy źródło jest niedostępne

Nieudany import nigdy nie pozostawia starej liczby. Jeśli źródła nie można odczytać, wiersz o tym informuje, a nazwy pozostają niezdefiniowane:

Stan źródła Komunikat w wierszu
Brak źródła Error: No note named “Assumptions”
Chronione hasłem Error: “Assumptions” is protected — unlock it to use its values
W Koszu Error: “Assumptions” is in the Trash — restore it to use its values
Korzysta z kolei z tej notatki Error: Circular use: A → B → A

Zmiana nazw i aktualność danych

Po zmianie nazwy źródła Varlig aktualizuje wskazujące je wiersze use. Otwarta notatka przelicza się po zmianie używanego źródła, a każda notatka ponownie odczytuje źródła przy otwarciu.

Każde źródło jest obliczane według własnych ustawień: ustawień regionalnych obliczeń, formatów wyników i przypiętych kursów. Notatka z jednego regionu zachowuje znaczenie, gdy korzysta z niej inna.

Panel wyjaśnienia pokazuje pochodzenie importowanej nazwy, na przykład rate = 1.08 (from Assumptions), więc zawsze odróżnisz wartość lokalną od współdzielonej.

Aby przed zmianą wartości sprawdzić zależności, zajrzyj do źródła. How Was This Read? dla definicji wartości lub funkcji pokazuje Used by 2 Notes i nazwy korzystających notatek, na przykład Invoice (uses every value). Backlinks źródła zaczyna się od Used in calculations by 2 notes, z informacją, co każda pobiera. Wiersze use nie są zwykłymi odsyłaczami zwrotnymi.