Notes Structure

Understanding Vino's Structure

Vino's Dependency on Vulpea

Vino operates on top of Vulpea and requires that all wine-related notes be accessible through vulpea-db. For detailed information on this, refer to [the Vulpea documentation][vupea].

Organising Notes

While there are no rigid rules for organising your notes, proper tagging is essential for Vino to distinguish between different types of notes. The main note types in Vino are:

1. Producer Notes (producer): Tagged as wine and producer. These notes represent wine producers. Vino does not expect any specific metadata for these notes.
2. Cellar Notes / Wine Entry Notes (cellar): Tagged as wine and cellar. These notes represent a specific release of wine. Cellar notes should contain certain metadata, as detailed in the corresponding section.
3. Rating Notes (rating): Tagged as wine and rating. These notes are ratings for specific wine entries and should include relevant metadata.
4. Country Notes (country): Tagged as wine and country. These notes represent countries.
5. Region Notes (region): Tagged as wine and region. These notes represent geographic wine regions.
6. Appellation Notes (appellation): Tagged as wine and appellation. These notes detail specific appellations. Cellar notes may link to either regions or appellations.
7. Grape Notes (grape): Tagged as wine and grape. These notes represent different grape varieties. Utilise Org Roam aliases to avoid duplication.

For certain note types, Vino may require specific metadata. Please refer to the documentation for each note type for more details. While Vino imposes some structure, you are free to add additional text, headings, and metadata.

Note Relationships

The relationships between these note types are as follows:

• Cellar notes link to one producer, region or appellation, multiple grapes, and multiple ratings.
• Rating notes link to one cellar.

Setting tags

You can set tags for your notes in multiple ways:

1. Using Templates: This is the default method. More information can be found in the Templates section.
2. Automatic Tagging Based on Directory: Requires additional setup, detailed in this blog post.

Directory Structure

While not mandatory, it is advisable to store all wine-related notes in a dedicated wine directory within your Vulpea notes directory. This helps to keep your notes organised and avoids clutter. A suggested directory structure is as follows:

.
└── wine
    ├── appellation
    │   ├── france
    │   │   ├── musigny_aoc.org
    │   │   ├── nuits_saint_georges_aoc.org
    │   │   └── ...
    │   ├── italy
    │   │   ├── cerasuolo_di_vittoria_docg.org
    │   │   ├── etna_doc.org
    │   │   ├── igp_terre_siciliane.org
    │   │   └── ...
    │   └── ...
    ├── cellar
    │   ├── 2c012cee-878b-4199-9d3b-782d671bd198.org
    │   ├── 4faf700f-c8b9-403d-977c-8dee9e577514.org
    │   ├── b20373db-43d3-4f2c-992c-6c6b5a4f3960.org
    │   ├── c9937e3e-c83d-4d8d-a612-6110e6706252.org
    │   └── ...
    ├── country
    │   ├── italy.org
    │   ├── france.org
    │   └── ...
    ├── grape
    │   ├── frappato.org
    │   ├── nerello_mascalese.org
    │   ├── nero_d_avola.org
    │   └── ...
    ├── producer
    │   ├── arianna_occhipinti.org
    │   ├── pyramid_valley.org
    │   └── ...
    ├── rating
    │   ├── be7777a9-7993-44cf-be9e-0ae65297a35d.org
    │   ├── bbc0c0f6-6f85-41a8-a386-f2017ceeaeb3.org
    │   ├── 727d03f3-828a-4957-aaa9-a19fd0438a15.org
    │   ├── d9e29c8e-06af-41d3-a573-72942cea64da.org
    │   ├── a5022e95-4584-43bd-ac55-599a942a6933.org
    │   └── ...
    └── region
        ├── new-zealand
        │   ├── central_otago.org
        │   ├── gisborne.org
        │   ├── kumeu.org
        │   └── ...
        ├── italy
        │   ├── sicily.org
        │   ├── piedmont.org
        │   └── ...
        └── ...

By default Vino craetes new notes that respect the suggested structure.

Other files may reside in your notes directory or the wine folder. However, dedicating specific directories for Vino files aids in better organisation. The templates in Vino are designed to support this structure out of box.