Формат данных

QVNote хранит все заметки как обычные файлы и папки в папке данных. Формат основан на JSON и удобен для чтения его можно просматривать любым файловым менеджером, копировать любым инструментом резервного копирования и обрабатывать собственными скриптами.

<папка данных>/
  config.json                        # конфигурация приложения
  Inbox.qvnotebook/                  # блокнот по умолчанию (всегда присутствует)
  Trash.qvnotebook/                  # корзина (всегда присутствует)
  <UUID>.qvnotebook/                 # блокнот
    meta.json                        # метаданные блокнота: name, uuid, tags, color
    <UUID>.qvnote/                   # заметка
      meta.json                      # метаданные заметки: title, tags, created_at, updated_at,
                                     # url_src (ссылка на оригинал), type, content_state
      content.json                   # содержимое заметки (HTML для текстовых заметок)
      resources/                     # вложения: изображения и файлы заметки

Блокноты и заметки

Каждый блокнот это папка с именем <UUID>.qvnotebook. В файле meta.json хранятся название блокнота, его уникальный идентификатор, теги и цвет.

Каждая заметка это папка <UUID>.qvnote внутри своего блокнота:

  • meta.json заголовок заметки, теги, даты создания/изменения, ссылка на оригинальную статью (url_src) для заметок, сохранённых из интернета, и тип заметки (текст или код).
  • content.json само содержимое заметки.
  • resources/ изображения и файлы, прикреплённые к заметке, включая изображения, автоматически скачанные с внешних сайтов.

Служебные файлы

Рядом с блокнотами в папке данных находятся служебные файлы, которыми управляет сама программа:

  • qvnote.db внутренняя база данных со служебными данными (теги, избранное)
  • search.bleve/ индекс полнотекстового поиска; можно удалить, он будет перестроен автоматически
  • webp-cache/ производный кэш изображений WebP; очищается со страницы настроек

Резервное копирование

Чтобы сделать резервную копию или перенести заметки, просто скопируйте папку данных целиком. Для восстановления верните её на место и при необходимости укажите программе путь к ней параметром --datadir (см. Настройка).