From 709d163e9c1e517037d50d6c42bb5a514ec6f735 Mon Sep 17 00:00:00 2001 From: Stuart Breckenridge Date: Thu, 23 Sep 2021 21:25:25 +0800 Subject: [PATCH] addtional notes in Themes.md --- Technotes/Themes.md | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/Technotes/Themes.md b/Technotes/Themes.md index 741e5e963..387c3cb65 100644 --- a/Technotes/Themes.md +++ b/Technotes/Themes.md @@ -1,7 +1,31 @@ # Themes -## Add Themes Directly to NetNewsWire -Theme developers: on iOS and macOS, themes can be opened directly in NetNewsWire using the below URL scheme: +## `.nnwtheme` Structure + +An `.nnwtheme` comprises of three files: +- `Info.plist` +- `template.html` +- `stylesheet.css` + +### Info.plist +The `Info.plist` requires the following keys/types: + +|Key|Type|Notes| +|---|---|---| +|`ThemeIdentifier`|`String`|Unique identifier for the theme, e.g. using reverse domain name.| +|`Name`|`String`|Theme name| +|`CreatorHomePage`|`String`|| +|`CreatorName`|`String`|| +|`Version`|`Integer`|| + +### template.html +This provides a starting point for editing the structure of the page. Theme variables are documented in the header. + +### stylesheet.css +This provides a starting point for editing the style of the page. + +## Add Themes Directly to NetNewsWire with URL Scheme +On iOS and macOS, themes can be opened directly in NetNewsWire using the below URL scheme: `netnewswire://theme/add?url={url}`