Files changed: - AGENTS.md - CHANGES.md - VERSION - docs/ownership-and-templates.md - instructions/migrations/6.0.0-type-guidance-split.md - instructions/setup-instance.md - tools/CONTRACT.md - tools/chemenu/commands/dist_cmd.py - tools/chemenu/commands/types_cmd.py - tools/chemenu/tests/test_dist_cmd.py - tools/chemenu/tests/test_dist_upgrade.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_types_cmd.py - tools/chemenu/type_resolver.py - tools/chemenu/types_core.py - types/comparison.guidance.md - types/comparison.md - types/concept.guidance.md - types/concept.md - types/entity.guidance.md - types/entity.md - types/source.guidance.md - types/source.md - types/type-guidance.md - types/type-guidance.schema.yaml - types/type-spec.md
3.4 KiB
type, name, description, schema, subtype_field, base_dir, title_prefix, page_ref_fields, capture_fields, guidance, layout
| type | name | description | schema | subtype_field | base_dir | title_prefix | page_ref_fields | capture_fields | guidance | layout | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| types/type-spec.md | source | Structured type for source pages that record and summarize ingested raw material | types/source.schema.yaml | source_type | sources | Source - |
|
|
types/source.guidance.md |
|
Source
This instance's configuration for the source type: its frontmatter fields as this schema
requires them, and the page skeleton wikitool new source scaffolds. When to use this type and
how to write a conforming page is types/source.guidance.md -
tools/wikitool types describe source composes both into one answer.
Frontmatter
| Field | Required | Use |
|---|---|---|
type |
Yes | types/source.md |
source_type |
Yes | One of: transcript, analysis, article, document, notes, tracker, unclassified - no default, see below |
author |
Yes | Originator of the source material |
raw_files |
Yes | Raw file paths this source owns - see "One raw file, one owner" below |
fidelity |
Yes (in the tool, not in the schema) | How faithful the capture is: verbatim, published, secondhand, nontextual - a capture field, see below |
authority |
Yes (in the tool, not in the schema) | What the material may claim about its subject: normative, reporting, opinion - a capture field, see below |
source_url |
No | Origin URL for external sources |
source_language |
No | ISO 639-1 code of the raw material's language, e.g. de, en, fr |
date |
Yes | Publication or creation date (YYYY-MM-DD) |
tags |
No | Navigation tags for categorization |
entities |
No | Titles of the entities mentioned in this source |
concepts |
No | Titles of the concepts mentioned in this source |
summary |
Yes | One-liner for kb/index.md |
Authoring guidance
- The title starts with "Source - ", followed by the name of the source
Template
The block below is page material, so it is written in this instance's KB language
(kb/CONVENTIONS.md language:) rather than in the control plane's English - its headings
become the headings of every page wikitool new source scaffolds.
# Source: {name}
**Autor:** {author}
**Datum:** {date}
**Raw-Dateien:** {raw_files|join}
**Typ:** {source_type|capitalize}
## Zusammenfassung
TODO: 2-3 Absätze zu den Kernaussagen des Quellmaterials.
## Kernaussagen
- TODO: Kernaussage 1
- TODO: Kernaussage 2
- TODO: Kernaussage 3
## Aufgaben
- [ ] TODO: Aufgabe 1
- [ ] TODO: Aufgabe 2
## Nicht übernommen
- TODO: Was bewusst nicht übernommen wurde, und warum (oder "nichts - die Quelle wurde vollständig erfasst")
## Verwandte Entities
{entities|bullets}
## Verwandte Concepts
{concepts|bullets}
# Source: stays as a prefix - it mirrors the title_prefix and with it the title the page is
linked and cited under. The value behind **Typ:** stays the English enum value. When
wikitool cite adds a citation, the tool-managed footnote block appears at the end of the page;
what it is called is the instance's decision in kb/CONVENTIONS.md (sections:).