View source for User:Eduralph/Sandbox/Addon Development — Sidebar

<!--
  Vault-internal map for the Addon Development section. NOT a published
  page (managed: false) — Obsidian users navigate by this; publish.py /
  md2pdf.py skip it.

  Ordering rationale: author journey. A reader new to Gramps addon work
  goes Overview -> Get started -> a tutorial -> picks the kind of addon
  they're building -> reads fundamentals when something doesn't behave
  the way they expected -> reaches for data access / API as the addon
  gets non-trivial -> testing / debug / troubleshoot when stuck ->
  code analysis / packaging when ready to ship -> compatibility /
  what's new when porting across Gramps versions.
-->

== Sidebar ==

# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development|Gramps 6.0 Wiki Manual - Addon Development]] — what an addon is, file roles, registration shape.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Getting_Started|Gramps 6.0 Wiki Manual - Addon Development - Getting Started]] — first Gramplet, restart loop, where addons live.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Tutorials|Gramps 6.0 Wiki Manual - Addon Development - Tutorials]] — end-to-end walkthroughs per addon kind.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Addon_Kinds|Gramps 6.0 Wiki Manual - Addon Development - Addon Kinds]] — Gramplets, Views, Reports, Tools, Importers, Exporters, Docgens, Quick reports, Sidebars, Map services, Relationship calculators, Rules.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Fundamentals|Gramps 6.0 Wiki Manual - Addon Development - Fundamentals]] — <code>.gpr.py</code> registration fields, plugin discovery, <code>_()</code> / <code>ngettext</code>, module-level loggers, lifecycle hooks.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Data_access|Gramps 6.0 Wiki Manual - Addon Development - Data access]] — <code>DbReadBase</code> / <code>DbWriteBase</code>, handles vs <code>gramps_id</code>, backlinks, transactions, what <code>gen/</code> exposes.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_API_Reference|Gramps 6.0 Wiki Manual - Addon Development - API Reference]] — curated <code>gramps.gen.*</code> surface addons are allowed to import; what's stable vs. what isn't.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Testing|Gramps 6.0 Wiki Manual - Addon Development - Testing]] — <code>unittest</code>-only, <code>test_*</code> filename conventions, mock-vs-<code>example.gramps</code> guidance, addon-unit runners.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Debug|Gramps 6.0 Wiki Manual - Addon Development - Debug]] — Gramps debug mode, log levels, repro scripts that bypass the GUI, <code>PrerequisitesCheckerGramplet</code>.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Troubleshoot|Gramps 6.0 Wiki Manual - Addon Development - Troubleshoot]] — common failure modes: silent reload, no-symlinks rule, namespace-package binding traps, <code>requires_mod</code> vs PyPI name.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Code_Analysis|Gramps 6.0 Wiki Manual - Addon Development - Code Analysis]] — Black, ruff E9/F63/F7/F82, <code>ast.parse</code>, mypy (for core); what the per-repo pre-commits enforce.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Internationalization|Gramps 6.0 Wiki Manual - Addon Development - Internationalization]] — i18n, translations, gettext, ''() / N''() handling, .po/.pot generation for addons.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Packaging|Gramps 6.0 Wiki Manual - Addon Development - Packaging]] — <code>make.py</code>, <code>addons-source</code> -&gt; <code>addons</code> flow, version-field rules, submitting to upstream.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Compatibility|Gramps 6.0 Wiki Manual - Addon Development - Compatibility]] — porting across Gramps versions; <code>gramps_target_version</code>; deprecated API surface; gramps60 vs gramps61 deltas.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_What's_New|Gramps 6.0 Wiki Manual - Addon Development - What's New]] — per-Gramps-version API changes that affect addons.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Rules|Gramps 6.0 Wiki Manual - Addon Development - Rules]] — normative MUST / SHOULD / MAY reference for addons and the contributor workflow. The page to cite in code review.
# [[User:Eduralph/Sandbox/Gramps_6.0_Wiki_Manual_-_Addon_Development_-_Roadmap|Gramps 6.0 Wiki Manual - Addon Development - Roadmap]] — forward-looking: in-flight changes, deprecations, open questions, and the documentation roadmap itself. Prospective counterpart to ''What's new''.

== Status ==

Section is being built out. Stubs (<code>managed: false</code>) won't appear in published output until promoted to <code>managed: true</code>.

<!-- This file is intentionally not a {{stub}} for the wiki — it lives
     vault-side only. -->