# Haki

# onNoteStored

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana, gdy notatka zostanie zapisana na dysku
  * Nie możesz modyfikować zapisanych notatek, ponieważ byłby to bałagan, ponieważ
  * najprawdopodobniej edytujesz je ręcznie w tym samym czasie
 *
 * @param {NoteApi} note - the note object of the stored note
 */
function onNoteStored(note);

1
2
3
4
5
6
7
8

Może zechcesz rzucić okiem na przykład on-note-opened.qml (opens new window).

# noteOpenedHook

# Wywołanie metody i parametry

/**
 * Ta funkcja jest wywoływana po otwarciu notatki
 *
 * @param {NoteApi} note - the note object that was opened
 */
function noteOpenedHook(note);

1
2
3
4
5
6

Może zechcesz rzucić okiem na przykład on-note-opened.qml (opens new window).

# noteDoubleClickedHook

# Wywołanie metody i parametry

/**
 * Ta funkcja jest wywoływana po dwukrotnym kliknięciu notatki
 *
 * @param {NoteApi} note - kliknięty obiekt notatki
 */
function noteDoubleClickedHook(note);

1
2
3
4
5
6

Może zechcesz rzucić okiem na przykład external-note-open.qml (opens new window).

# insertMediaHook

Ta funkcja jest wywoływana, gdy plik multimedialny jest wstawiany do bieżącej notatki.

Jeśli ta funkcja jest zdefiniowana w wielu skryptach, wygrywa pierwszy skrypt, który zwróci niepusty ciąg.

# Wywołanie metody i parametry

/**
 * @param fileName string the file path of the source media file before it was copied to the media folder
 * @param markdownText string the markdown text of the media file, e.g. ![my-image](media/my-image-4101461585.jpg)
 * @return string the new markdown text of the media file
 */
function insertMediaHook(fileName, markdownText);

1
2
3
4
5
6

Może zechcesz rzucić okiem na przykład example.qml (opens new window).

# insertAttachmentHook

Ta funkcja jest wywoływana, gdy plik załącznika jest wstawiany do bieżącej notatki.

Jeśli ta funkcja jest zdefiniowana w wielu skryptach, wygrywa pierwszy skrypt, który zwróci niepusty ciąg.

# Wywołanie metody i parametry

/**
 * @param fileName string the file path of the source attachment file before it was copied to the attachment folder
 * @param markdownText string the markdown text of the attachment file, e.g. [my-file.txt](attachments/my-file-4245650967.txt)
 * @return string the new markdown text of the attachment file
 */
function insertAttachmentHook(fileName, markdownText);

1
2
3
4
5
6

Może zechcesz rzucić okiem na przykład example.qml (opens new window).

# insertingFromMimeDataHook

# Wywołanie metody i parametry

/**
 * Ta funkcja jest wywoływana, gdy html lub plik multimedialny jest wklejany do notatki za pomocą `Ctrl + Shift + V`
 *
 * Tekst @param text obiektu QMimeData
 * @param html html obiektu QMimeData
 * @zwraca ciąg, który należy wstawić zamiast tekstu z obiektu QMimeData
 */
funkcja insertingFromMimeDataHook(text, html);

1
2
3
4
5
6
7
8

Może zechcesz rzucić okiem na przykład example.qml (opens new window), insert-headline-with-link-from-github-url.qml (opens new window) or note-text-from-5pm-mail.qml (opens new window).

# handleNoteTextFileNameHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana, gdy notatka zostanie zapisana na dysku, jeśli
  * "Zezwalaj, aby nazwa pliku notatki różniła się od nagłówka" jest włączona
  * w ustawieniach
  *
  * Pozwala zmienić nazwę pliku notatki
  * Pamiętaj, że sam musisz zadbać o zduplikowane nazwy!
 *
  * Zwróć pusty ciąg, jeśli nazwa pliku notatki powinna
  * nie można modyfikować
  *
  * @param {NoteApi} note - obiekt notatki przechowywanej notatki
  * @return {string} nazwa pliku notatki
  */
funkcja handleNoteTextFileNameHook(note);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Może zechcesz rzucić okiem na przykład example.qml (opens new window) or use-tag-names-in-filename.qml (opens new window).

# handleNoteNameHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana, gdy nazwa nuty jest określona dla nuty
  *
  * Pozwala zmienić nazwę wyświetlanej notatki
  *
  * Zwróć pusty ciąg, jeśli nazwa notatki nie powinna być modyfikowana
  *
  * @param {NoteApi} note - obiekt notatki przechowywanej notatki
  * @return {string} nazwa notatki
  */
funkcja handleNoteNameHook(uwaga);

1
2
3
4
5
6
7
8
9
10
11

Może zechcesz rzucić okiem na przykład example.qml (opens new window).

Używanie tego haka może nie być dobrym pomysłem, jeśli ustawienie używania nazwy pliku jako nazwy notatki jest aktywne.

# handleNewNoteHeadlineHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana przed utworzeniem notatki
  *
  * Pozwala modyfikować nagłówek notatki przed jej utworzeniem
  * Pamiętaj, że musisz zadbać o unikalną nazwę notatki, w przeciwnym razie
  * nowa notatka nie zostanie utworzona, zostanie po prostu znaleziona na liście notatek
  *
  * Możesz użyć tej funkcji do tworzenia szablonów notatek
  *
  * @param tekst nagłówka, który zostałby użyty do utworzenia nagłówka
  * @return {string} nagłówek notatki
  */
uchwyt funkcjiNowaUwagaNagłówekHook(nagłówek);

1
2
3
4
5
6
7
8
9
10
11
12
13

Może zechcesz rzucić okiem na przykład custom-new-note-headline.qml (opens new window).

# preNoteToMarkdownHtmlHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana przed wygenerowaniem kodu html notatki
  *
  * Pozwala modyfikować to, co jest przekazywane do konwertera przecen do html
  *
  * Funkcja może być używana na przykład w wielu skryptach do renderowania kodu (takich jak matematyka LaTeX lub syrenka)
  * do jego graficznej reprezentacji do podglądu
  *
  * Notatka nie zostanie zmieniona w tym procesie
  *
  * Notatka @param {NoteApi} – obiekt notatki
  * @param {string} przecena - przecena, która ma zostać przekonwertowana na html
  * @param {bool} forExport - true jeśli html jest używany do eksportu, false dla podglądu
  * @return {string} zmodyfikowany przecena lub pusty ciąg, jeśli nic nie powinno być modyfikowane
  */
funkcja preNoteToMarkdownHtmlHook(note, markdown, forExport);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

Może zechcesz rzucić okiem na przykład preview-styling.qml (opens new window).

# noteToMarkdownHtmlHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana, gdy generowany jest znacznik html notatki
  *
  * Pozwala na modyfikację tego html
  * Jest to na przykład nazywane wcześniej w podglądzie notatki
  *
  * Funkcja może być używana w wielu skryptach do modyfikowania html podglądu
  *
  * Notatka @param {NoteApi} – obiekt notatki
  * @param {string} html - html, który ma zostać wyrenderowany
  * @param {bool} forExport - true jeśli html jest używany do eksportu, false dla podglądu
  * @return {string} zmodyfikowany html lub pusty ciąg, jeśli nic nie powinno być modyfikowane
  */
funkcja noteToMarkdownHtmlHook(note, html, forExport);

1
2
3
4
5
6
7
8
9
10
11
12
13
14

Może zechcesz rzucić okiem na przykład example.qml (opens new window) or preview-styling.qml (opens new window).

Proszę zapoznać się z Obsługiwanym kodem HTML Dokumentacja podzbioru (opens new window) aby zobaczyć listę wszystkich obsługiwanych stylów CSS.

# encryptionHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana, gdy tekst ma być zaszyfrowany lub odszyfrowany
  *
  * @param ciąg tekstowy tekst do zaszyfrowania lub odszyfrowania
  * @param hasło ciąg hasła
  * @param decrypt bool, jeśli wymagane jest fałszywe szyfrowanie, jeśli wymagane jest prawdziwe odszyfrowanie
  * @zwróć zaszyfrowany odszyfrowany tekst
  */
funkcja szyfrowaniaHook (tekst, hasło, odszyfrowanie);

1
2
3
4
5
6
7
8
9

Może zechcesz rzucić okiem na przykład encryption-keybase.qml (opens new window), encryption-pgp.qml (opens new window) lub encryption-rot13.qml (opens new window).

# noteTaggingHook

Możesz zaimplementować własny mechanizm tagowania notatek, na przykład za pomocą specjalnego tekstu w swojej notatce, takiego jak @tag1, @tag2, @tag3.

# Wywołanie metody i parametry

/**
  * Obsługuje tagowanie notatek dla notatki
  *
  * Ta funkcja jest wywoływana, gdy tagi są dodawane, usuwane lub zmieniane w
  * notatka lub tagi notatki powinny być wymienione
  *
  * @param uwaga
  * Akcja @param może być „dodaj”, „usuń”, „zmień nazwę” lub „lista”
  * @param tagName nazwa tagu do dodania, usunięcia lub zmiany nazwy
  * @param newTagName nazwa tagu do zmiany nazwy, jeśli akcja = „zmień nazwę”
  * @return note ciąg tekstowy lub lista ciągów nazw tagów (jeśli akcja = „lista”)
  */
funkcja noteTaggingHook(notatka, akcja, nazwa_znacznika, nazwa_nowa_znacznika);

1
2
3
4
5
6
7
8
9
10
11
12
13

jak tylko zostanie aktywowany skrypt implementujący nową funkcję noteTaggingHook tagowanie notatek będzie obsługiwane przez tę funkcję
następujące funkcje powinny działać w interfejsie użytkownika QOwnNotes
- początkowo importował tagi, takie jak @tag z twoich notatek i nadpisywanie aktualnego przypisania tagu
  - nie stracisz swojego drzewa tagów, tylko poprzednie zadanie do notatek
  - nadal możesz przenosić tagi do innych tagów
  - jeśli więcej niż jeden tag ma taką samą nazwę w twoim drzewie tagów, pierwsze trafienie zostanie przypisane
- dodanie tagu do notatki spowoduje dodanie tagu do tekstu notatki
- usunięcie znacznika z notatki spowoduje usunięcie znacznika z tekstu notatki
- usunięcie tagów z listy tagów spowoduje usunięcie tych tagów z twojego notatki
- zmiana nazw tagów na liście tagów spowoduje zmianę nazw tagów w twoim notatki
- zbiorcze tagowanie notatek na liście notatek doda te tagi do twojego notatki
- masowe usuwanie tagów z notatek na liście notatek spowoduje usunięcie te tagi z twoich notatek
- aplikacja uruchomi serię dodaj i usuń dla wszystkie zaznaczone tagi i ich dzieci we wszystkich notatkach, jeśli tagi są przesunięte w panelu tagów

Może zechcesz rzucić okiem na przykład note-tagging.qml (opens new window) zaimplementuj własny mechanizm tagowania.

WARNING

Upewnij się, że akcja listy jest naprawdę szybka, ponieważ zostanie wykonana dla każdej notatki za każdym razem, gdy folder notatek zostanie ponownie załadowany!

# noteTaggingByObjectHook

Podobnie jak w przypadku noteTaggingHook, możesz zaimplementować własny mechanizm tagowania notatek, ale nie jesteś związany z nazwami tagów w korzeniu drzewa tagów. W ten sposób możesz wykorzystać całe drzewo tagów zamiast tylko listy tagów.

Dzięki noteTaggingByObjectHook otrzymujesz jako parametr obiekt TagApi zamiast nazwy tagu. W rezultacie dla akcji lista musisz podać listę identyfikatorów tagów.

Oznacza to również, że musisz samodzielnie utworzyć brakujące tagi, aby móc dostarczyć listę już istniejących identyfikatorów tagów dla akcji lista.

# Wywołanie metody i parametry

/**
  * Obsługuje tagowanie notatek dla notatki
  *
  * Ta funkcja jest wywoływana, gdy tagi są dodawane, usuwane lub zmieniane w
  * notatka lub tagi notatki powinny być wymienione
  *
  * @param uwaga
  * Akcja @param może być „dodaj”, „usuń”, „zmień nazwę” lub „lista”
  * @param tag do dodania, usunięcia lub zmiany nazwy
  * @param newTagName nazwa tagu do zmiany nazwy, jeśli akcja = „zmień nazwę”
  * @return note ciąg tekstowy lub ciąg-lista identyfikatorów tagów (jeśli action = „list”)
  */
funkcja noteTaggingByObjectHook(notatka, akcja, tag, nowaNazwaTag);

1
2
3
4
5
6
7
8
9
10
11
12
13

Może zechcesz rzucić okiem na przykład note-tagging-by-object.qml (opens new window) zaimplementuj własny mechanizm tagowania.

# autocompletionHook

Możesz zwrócić listę ciągów, które mają zostać dodane do listy autouzupełniania po wywołaniu autouzupełniania (na przykład naciskając Ctrl + spacja).

# Wywołanie metody i parametry

/**
  * Wywołuje funkcję autocompletionHook dla wszystkich komponentów skryptu
  * Ta funkcja jest wywoływana, gdy w notatce wywoływane jest autouzupełnianie
  *
  * @return QStringList tekstu dla listy autouzupełniania
  */
wywołanie funkcjiAutouzupełnianieHook();

1
2
3
4
5
6
7

Może zechcesz rzucić okiem na przykład autocompletion.qml (opens new window).

# websocketRawDataHook

Ten zaczep jest wywoływany, gdy dane są wysyłane z przeglądarki QOwnNotes Web Companion rozszerzenie poprzez menu kontekstowe przeglądarki internetowej.

# Wywołanie metody i parametry

/**
 * @param requestType can be "page" or "selection"
 * @param pageUrl the url of the webpage where the request was made
 * @param pageTitle the page title of the webpage where the request was made
 * @param rawData the data that was transmitted, html for requestType "page" or plain text for requestType "selection"
 * @param screenshotDataUrl the data url of the screenshot of the webpage where the request was made
 * @return true if data was handled by a hook
 */
function callHandleWebsocketRawDataHook(requestType, pageUrl, pageTitle, rawData, screenshotDataUrl);

1
2
3
4
5
6
7
8
9

Może zechcesz rzucić okiem na przykład websocket-raw-data-new-note.qml (opens new window) i websocket-raw-data-selection-in-note.qml (opens new window).

# onDetachedProcessCallback

Ten zaczep jest wywoływany, gdy wątek skryptu startDetachedProcess jest wykonywany.

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana po zakończeniu wykonywania wątku skryptu.
 * Podpowiedź: thread[1]==0 pomaga określić, czy większość uruchomionych procesów dla określonego identyfikatora została wykonana.
 *
 * @param {QString} callbackIdentifier - the provided id when calling startDetachedProcess()
 * @param {QString} resultSet - the result of the process
 * @param {QVariantList} cmd - the entire command array [0-executablePath, 1-parameters, 2-exitCode]
 * @param {QVariantList} thread - the thread information array [0-passed callbackParameter, 1-remaining threads for this identifier]
 */
function onDetachedProcessCallback(callbackIdentifier, resultSet, cmd, thread);

1
2
3
4
5
6
7
8
9
10

Może zechcesz rzucić okiem na przykład callback-example.qml (opens new window).

# windowStateChangedHook

# Wywołanie metody i parametry

/**
  * Ta funkcja jest wywoływana po wyzwoleniu zdarzenia WindowStateChange
 *
 * @param {QString} windowState - the new window state, parameter value can be "minimized", "maximized", "fullscreen", "active" or "nostate"
 */
function windowStateChangedHook(windowState);

1
2
3
4
5
6

Może zechcesz rzucić okiem na przykład window-state-changed.qml (opens new window).

# workspaceSwitchedHook

This hook is called when workspaces are switched.

# Wywołanie metody i parametry

/**
 * This function is called when workspaces are switched
 *
 * @param oldUuid old uuid of workspace
 * @param newUuid new uuid of workspace
 */
function workspaceSwitchedHook(oldUuid, newUuid);

1
2
3
4
5
6
7

Może zechcesz rzucić okiem na przykład websocket-raw-data-new-note.qml (opens new window).

# openAiBackendsHook

This hook is called, when the OpenAI service config is reloaded. For example, this is also done when the script engine is reloaded.

You can use it to provide config for custom OpenAI backends, like your own OpenAI API compatible LLMs.

# Method call and parameters

/**
 * This function is called when the OpenAI service config is reloaded
 * It returns a list of objects with config parameters for new OpenAI backends
 */
function openAiBackendsHook() {
    return [
        {
            "id": "my-custom-ai",
            "name": "My Custom AI",
            "baseUrl": "http://localhost:5000",
            "apiKey": "kDFJkjk3asdm",
            "models": ["gpt-3.5-turbo", "gpt-4.0-turbo"],
        },
        {
            "id": "my-custom-ai2",
            "name": "My Custom AI 2",
            "baseUrl": "http://localhost:5001",
            "apiKey": "lOikf7eNdb9",
            "models": ["gpt-3.5-turbo2", "gpt-4.0-turbo2"],
        },
    ];
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

TIP

You can use Registering script settings variables to store the OpenAI backend settings in the script settings.

You may want to take a look at the example custom-openai-backends.qml (opens new window).

← Methods and objects QOwnNotes provides Odsłonięte zajęcia →

Crafted by Patrizio Bekerle with ❤️