mirror of
https://github.com/Ranchero-Software/NetNewsWire
synced 2025-08-12 06:26:36 +00:00
Delete help book from Technotes. Delete some obsolete notes.
This commit is contained in:
Brent Simmons
@@ -1,32 +0,0 @@
|
||||
|
||||
# NetNewsWire Branching Strategy
|
||||
|
||||
The main repository for NetNewsWire utilizes a [Trunk Based Development](https://trunkbaseddevelopment.com) branching strategy. This branching strategy is a variant of [Three-Flow](https://www.nomachetejuggling.com/2017/04/09/a-different-branching-strategy/).
|
||||
|
||||
## Three-Flow
|
||||
|
||||
Three-Flow uses 3 branches to facilitate development, stabilize a release, and manage production hotfixes. Development happens on Main and moves to a branch called Candidate when it is ready to be stabilized. New feature development continues on Main and bug fixes to the release candidate happen on Candidate. When the product is released, it is pushed to the Release branch. Hotfixes can happen on the Release branch. Candidate is now free to be reused to stabilize the next release. All bugs found and fixed are back merged to Candidate and then Main respectively.
|
||||
|
||||
|
||||
|
||||
All arrows going up are promotions (pushes) to the next environment. All arrows going down are back ports of bugfixes.
|
||||
|
||||
That is Three-Flow applied to NetNewsWire. It would be that simple, but we have two products we are going to deliver from the same repository. The iOS and the macOS variants of NetNewsWire. To stabilize and manage both variants, each will need to be given their own Candidate and Release branches.
|
||||
|
||||
|
||||
|
||||
Today (6/12/2019) we have 2 branches, main and macOS Candidate, in the main repository which will eventually grow to be 5 branches.
|
||||
|
||||
There will also be a number of repository forks that NetNewWire developers will create to do bug fixes and implement new features (not shown here). Typically, contributors will fork the Main branch to their own repository. They would then create a feature/bugfix branch on their repository. Once work on their forked branch is complete, they will submit a pull request to be merged back into the main repository main.
|
||||
|
||||
## Tagging
|
||||
|
||||
Each release should be tagged using [Semantic Versioning](https://semver.org/). Candidates will continue to be tagged using the current convention which denotes the difference between developer, alpha and beta releases. Additionally, we will need to use a convention to avoid tag name collisions between iOS and macOS products. macOS releases will be suffixed with "mac-" and iOS releases will be suffixed with "ios-". (See the above diagram for examples.)
|
||||
|
||||
## Packages
|
||||
|
||||
NetNewsWire uses Swift Packages to manage project dependencies. All the packages are under the same project umbrella as NetNewWire and there are no third-party dependencies to manage. These packages are mostly stable at this point. For simplicity’s sake, all development on the packages will continue on their repository Main branch. These packages won’t be managed as separate projects with separate releases/tags at this time.
|
||||
|
||||
## Summary
|
||||
|
||||
There are 3 types of branches: Main, Candidate, and Release. All feature development happens on Main. Stabilization happens on Candidate. Hotfixes happen on Release. Each product gets its own Candidate and Release branches. All candidates and releases get tagged.
|
||||
@@ -1,29 +0,0 @@
|
||||
# NetNewsWire Continuous Integration
|
||||
|
||||
CI for NetNewsWire is enabled through Github Actions. The CI workflow configuration (hosted in
|
||||
[`.github/workflows/build.yml`](https://github.com/brentsimmons/NetNewsWire/blob/main/.github/workflows/build.yml)
|
||||
uses `xcodebuild` to build the project after syncing the repository and the various submodules.
|
||||
|
||||
The build itself focuses on the scheme NetNewsWire for macOS and NetNewsWire-iOS for iOS. Also it leverages the
|
||||
`NetNewsWire.xcworkspace` configuration.
|
||||
|
||||
Private keys, certificates and provisioning profiles are stored in Github under `buildscripts` folder. Decrypting necessary certificates, copy to build machine keychain and delete the certificates are handled by the [`buildscripts/ci-build.sh`](https://github.com/Ranchero-Software/NetNewsWire/blob/main/buildscripts/ci-build.sh) script.
|
||||
|
||||
Each submodule also has it's own CI configuration, which are set up and built from
|
||||
their own repositories. The submodule CI systems are entirely independent so that
|
||||
those libraries can grow and change, getting CI verification, independent of NetNewsWire.
|
||||
|
||||
Build failures are notified to our slack group via [Notify Slack](https://github.com/8398a7/action-slack) GitHub action.
|
||||
|
||||
The submodule CI are typically set to run a build and any available tests. Refer to the
|
||||
project repository for the current and complete list of submodules, but for quick reference:
|
||||
|
||||
- [RSCore](https://github.com/brentsimmons/RSCore)
|
||||
|
||||
- [RSWeb](https://github.com/brentsimmons/RSWeb) 
|
||||
|
||||
- [RSParser](https://github.com/brentsimmons/RSParser)
|
||||
|
||||
- [RSTree](https://github.com/brentsimmons/RSTree)
|
||||
|
||||
- [RSDatabase](https://github.com/brentsimmons/RSDatabase) 
|
||||
@@ -1,50 +0,0 @@
|
||||
# Dark Mode - WWDC 2018
|
||||
|
||||
https://developer.apple.com/documentation/appkit/supporting_dark_mode_in_your_interface
|
||||
https://developer.apple.com/videos/play/wwdc2018/210/
|
||||
|
||||
- Accent colors
|
||||
- Can do preference for content — see Mail for example
|
||||
- linkColor — see if can use in web view
|
||||
- icons in sidebar should not be vibrant
|
||||
- Use opaque grayscale colors, not opacity, on top of vibrancy
|
||||
- Colors in asset catalogs
|
||||
- Specify for different appearances
|
||||
- High contrast colors
|
||||
- Dynamic system colors
|
||||
- Resolved at draw time
|
||||
- Pictures in asset catalogs
|
||||
- Template images
|
||||
- contentTintColor new API - NSImageView, NSButton
|
||||
- Render as template image thing in IB
|
||||
- controlAccentColor
|
||||
- color.withSystemEffect(.pressed)
|
||||
- Avoid nonsemantic materials
|
||||
- Semantic materials: popover, menu, sidebar, selection, titlebar, etc.
|
||||
- visualEffectView.material = .popover
|
||||
- Desktop tinted background: window background, underpage, content background
|
||||
- contentBackground default for collection views
|
||||
- Use NSAppearance to override inheritance
|
||||
- .aqua
|
||||
- .darkAqua
|
||||
- effectiveAppearance
|
||||
|
||||
Advanced Dark Mode:
|
||||
https://developer.apple.com/videos/play/wwdc2018/218/
|
||||
|
||||
- Build with 10.14 SDK
|
||||
- NSAppearanceCustomization
|
||||
- NSView, NSWindow conforms
|
||||
- NSWindow.appearanceSource
|
||||
- Configure NSBox to fill color to get desired material
|
||||
- visualEffectView.maskImage
|
||||
- Can do drawing handler images - for instance with a path
|
||||
- backgroundStyle on rows - .normal and .emphasized
|
||||
|
||||
- Backward deployment…
|
||||
- Most system colors are available pre-Mo
|
||||
- Asset catalogs available on 10.13
|
||||
- Find hardcoded colors, use asset catalog colors
|
||||
- NSColor(named: "SomeColor")
|
||||
- Prefer block-based image drawing instead of lockFocus
|
||||
- Prefer NSTextField to drawing strings
|
||||
@@ -1,51 +0,0 @@
|
||||
@title How to add a feed to NetNewsWire
|
||||
|
||||
# How to add a feed to NetNewsWire
|
||||
|
||||
NetNewsWire collects items for you from feeds published on web sites. To do this, NetNewsWire needs to know the address for the feed, e.g. `https://inessential.com/feed.xml`.
|
||||
|
||||
*It’s okay if you don’t know that.* NetNewsWire will look at any web page and try to find it for you. All you need to give is the site’s URL, like `inessential.com`.
|
||||
|
||||
To get started, click the Add Feed button on the toolbar, or use **File → New Feed** (⌘-N) from the menu bar.
|
||||
|
||||
If you’ve got the address already – great! Type it or paste it into the URL box. Otherwise, just enter the website’s address into the box.
|
||||
|
||||
Before you finish, you can choose an alternative name for the feed and where it will be stored (see below).
|
||||
|
||||
Click ‘Add’ and NetNewsWire will fetch the URL you entered. If you entered an address that’s not a feed, NetNewsWire will search the page and add the feed it finds.
|
||||
|
||||
|
||||
|
||||
Choosing an alternative name for a feed
|
||||
---------------------------------------
|
||||
|
||||
Feeds specify their own name, but you may want to change it to something easier to remember. ‘Brent’ rather than ‘inessential’, for example. You also change this later in the [feed inspector].
|
||||
|
||||
|
||||
|
||||
Choosing a feed’s folder
|
||||
------------------------
|
||||
|
||||
Before you add a feed, you can choose the account and folder where it will be saved.
|
||||
|
||||
This option is especially important if you’re using multiple accounts. You can choose whether to save the subscription to your [On My Mac](on-my-mac.html) account or [Feedbin](syncing-accounts.html) account.
|
||||
|
||||
In either case, if you use folders, you can also choose which one keep the feed in.
|
||||
|
||||
|
||||
|
||||
What to do when NetNewsWire can’t find a feed
|
||||
---------------------------------------------
|
||||
|
||||
Sometimes NetNewsWire won’t be able to find a feed for a site. Either the site doesn’t offer a feed, or the feed isn’t advertised in a way that NetNewsWire can find it.
|
||||
|
||||
You may be able to find a feed manually by visiting the site. There, look for a link to an RSS, Atom or JSON feed. If one exists, you can add this direct URL to NetNewsWire using the process above. Right-click on the link and copy the URL to paste into NetNewsWire.
|
||||
|
||||
|
||||
|
||||
Other ways to add feeds
|
||||
-----------------------
|
||||
|
||||
Adding feeds in the NetNewsWire app isn’t the only way. You can also add feeds from Safari using the [NetNewsWire Safari Extension](safari-extension.html).
|
||||
|
||||
If you have an existing OPML subscription list from another app or service, you can [import those feeds into NetNewsWire](import-opml.html), too.
|
||||
@@ -1,21 +0,0 @@
|
||||
@title Contributing
|
||||
|
||||
# Contributing
|
||||
|
||||
NetNewsWire is open-source and contributions from the community are welcomed.
|
||||
|
||||
There are two channels for contributing. There is a Slack group for conducting discussions. For filing tickets, and contributing code or documentation, we use GitHub.
|
||||
|
||||
|
||||
|
||||
Slack
|
||||
-----
|
||||
|
||||
[Join the Slack group](https://join.slack.com/t/netnewswire/shared_invite/enQtNjM4MDA1MjQzMDkzLTNlNjBhOWVhYzdhYjA4ZWFhMzQ1MTUxYjU0NTE5ZGY0YzYwZWJhNjYwNTNmNTg2NjIwYWY4YzhlYzk5NmU3ZTc) to talk with other NetNewsWire users — and to help out, if you’d like to, by testing, coding, writing, providing feedback, or just helping us think things through. Everybody is welcome and encouraged to join.
|
||||
|
||||
|
||||
|
||||
GitHub
|
||||
------
|
||||
|
||||
The [NetNewsWire project on GitHub](https://github.com/brentsimmons/NetNewsWire) is the place to raise formal issues like bugs and feature requests. If you want to make contributions to NetNewsWire’s code or documentation, please refer to our [contribution guidelines](https://github.com/brentsimmons/NetNewsWire/blob/main/CONTRIBUTING.md) page on GitHub.
|
||||
@@ -1,12 +0,0 @@
|
||||
@title Deleting feeds and folders
|
||||
|
||||
# Deleting feeds and folders
|
||||
|
||||
To delete a feed or folder, select it from the subscription list and choose **Edit → Delete** from the menu bar. Alternatively, select the feed and press the **delete** key.
|
||||
|
||||
|
||||
|
||||
Undo deleting a feed or folder
|
||||
------------------------------
|
||||
|
||||
If you change your mind, you can undo the deletion by selecting **Edit → Undo** in the menu bar or pressing ⌘-Z.
|
||||
@@ -1,14 +0,0 @@
|
||||
@title How to export OPML
|
||||
|
||||
# How to export OPML
|
||||
|
||||
Your subscription list is portable, meaning you can easily switch to another app or service at any time. NetNewsWire can export an OPML file containing all your subscriptions. This file format is well-established and widely supported for just this purpose.
|
||||
|
||||
1. From the menu bar, select **File → Export Subscriptions…**
|
||||
2. If you have multiple accounts, select which account’s subscriptions to export
|
||||
3. Choose the name and location for the OPML file
|
||||
4. Click **Export OPML**
|
||||
|
||||
Your subscriptions in NetNewsWire are unaffected by this action. Nothing is changed or removed.
|
||||
|
||||
You can now use this file for any app or service which allows you to import OPML-formatted subscription lists.
|
||||
@@ -1,16 +0,0 @@
|
||||
@title How to import OPML
|
||||
|
||||
# How to import OPML
|
||||
|
||||
You can use an OPML subscription list to import your subscriptions from another app or service into NetNewsWire.
|
||||
|
||||
First you need to get an OPML file. This should be pretty easy – look for export options in the app or the service’s web site.
|
||||
|
||||
Once you’ve got the OPML file, NetNewsWire can make quick work of importing the items within.
|
||||
|
||||
1. From the menu bar, select **File → Import Subscriptions…**
|
||||
2. If you have multiple accounts, select which account to receive the new subscriptions
|
||||
3. Navigate to the OPML file’s location
|
||||
4. Select it and click **Open**
|
||||
|
||||
NetNewsWire won’t replace your current subscription list. The new subscriptions will be added in addition to your current ones.
|
||||
@@ -1,55 +0,0 @@
|
||||
@title Keyboard shortcuts
|
||||
|
||||
# Keyboard shortcuts
|
||||
|
||||
NetNewsWire’s interface is easily navigable using keyboard shortcuts.
|
||||
|
||||
The most useful shortcuts are for reading articles: **space** to scroll articles and jump to the next unread one, or **n** to jump immediately to the next unread article. There’s also **b** to open the article in your browser (the **Return** or **Enter** keys work too).
|
||||
|
||||
|
||||
|
||||
In-app list of keyboard shortcuts
|
||||
---------------------------------
|
||||
|
||||
A comprehensive list of NetNewsWire’s keyboard shortcuts is always accessible to you in NetNewsWire. Just click on **Help → Keyboard Shortcuts** in the menu bar.
|
||||
|
||||
The list opens in a separate window which you can leave open to remind you of the keys to press. *You’ll be a NetNewsWire keyboard magician in no time.*
|
||||
|
||||
|
||||
### Do I need to use the Command key?
|
||||
|
||||
No, the Command (⌘) key isn’t required for these advanced keyboard shortcuts – just press the key by itself.
|
||||
|
||||
|
||||
|
||||
NetNewsWire’s keyboard shortcuts
|
||||
--------------------------------
|
||||
|
||||
Many of NetNewsWire’s shortcuts work from anywhere in the app. Others only work when a certain pane is active and highlighted.
|
||||
|
||||
<!-- From in-app shortcut page -->
|
||||
<table>
|
||||
<tr><th>Everywhere in NetNewsWire</th></tr>
|
||||
<tr><td>Scroll or go to next unread</td> <td>space</td></tr>
|
||||
<tr><td>Go to next unread</td> <td>n or +</td></tr>
|
||||
<tr><td>Mark as read</td> <td>r</td></tr>
|
||||
<tr><td>Mark all as read</td> <td>k</td></tr>
|
||||
<tr><td>Mark older articles as read</td> <td>o</td></tr>
|
||||
<tr><td>Mark all as read, go to next unread</td> <td>l</td></tr>
|
||||
<tr><td>Mark as unread, go to next unread</td> <td>m</td></tr>
|
||||
<tr><td>Mark as unread</td> <td>u</td></tr>
|
||||
<tr><td>Open in browser</td> <td>b or ⏎ or Enter</td></tr>
|
||||
<tr><td>Previous subscription</td> <td>a</td></tr>
|
||||
<tr><td>Next subscription</td> <td>z</td></tr>
|
||||
<tr><th>Feed list (left pane)</th></tr>
|
||||
<tr><td>Collapse</td> <td>, or ⌥+←</td></tr>
|
||||
<tr><td>Expand</td> <td>. or ⌥+→</td></tr>
|
||||
<tr><td>Collapse All (except for group items)</td> <td>; or ⌥+⌘+←</td></tr>
|
||||
<tr><td>Expand All</td> <td>' or ⌥+⌘+→</td></tr>
|
||||
<tr><td>Move focus to headlines</td> <td>→</td></tr>
|
||||
<tr><th>Article list timeline (centre pane)</th></tr>
|
||||
<tr><td>Move focus to subscriptions</td> <td>←</td></tr>
|
||||
<tr><td>Move focus to detail</td> <td>→</td></tr>
|
||||
<tr><th>Article reader (right pane)</th></tr>
|
||||
<tr><td>Move focus to headlines</td> <td>←</td></tr>
|
||||
</table>
|
||||
@@ -1,16 +0,0 @@
|
||||
@title How to get NetNewsWire news
|
||||
|
||||
# How to get NetNewsWire news
|
||||
|
||||
The very best way to get news about NetNewsWire is with NetNewsWire itself, using the *NetNewsWire News Feed*. Important and notable news about NetNewsWire will appear there: new version announcements, critical bug notices, tech notes and important project announcements.
|
||||
|
||||
|
||||
|
||||
Add the NetNewsWire News Feed
|
||||
-----------------------------
|
||||
|
||||
The NetNewsWire News Feed is part of the default subscription list installed the first time you launched NetNewsWire. If it’s no longer in your list, it’s easy to add it back.
|
||||
|
||||
In the menu bar, select **Help → Add NetNewsWire News Feed**. NetNewsWire will open the [New Feed dialog](adding-feeds.html) pre-filled with the name and address (`https://netnewswire.blog/feed.json`). Click Add.
|
||||
|
||||
Now you’ll always be up to date with what’s happening with NetNewsWire.
|
||||
@@ -1,40 +0,0 @@
|
||||
@title The On My Mac account
|
||||
|
||||
# The On My Mac account
|
||||
|
||||
The On My Mac account is the simplest way to use NetNewsWire. Using it requires no additional service or software. It’s just you, your subscriptions and NetNewsWire.
|
||||
|
||||
On My Mac subscriptions are wholly managed by NetNewsWire. It keeps your subscription list and is responsible for fetching the feeds and checking for updates. This means it also keeps track of what items you’ve read or not.
|
||||
|
||||
The On My Mac account does not sync this data to any other location. It works best for those people who only read NetNewsWire feeds on one Mac and nowhere else.
|
||||
|
||||
*NetNewsWire can also be used with a [syncing account](syncing-accounts.html) service like Feedbin.*
|
||||
|
||||
|
||||
Refreshing On My Mac feeds
|
||||
--------------------------
|
||||
|
||||
The feeds in the On My Mac account will be refreshed automatically whenever you open NetNewsWire. If left open, NetNewsWire will refresh your feeds every hour, or according to the schedule you set in Preferences.
|
||||
|
||||
|
||||
|
||||
If you don’t use the On My Mac account
|
||||
--------------------------------------
|
||||
|
||||
If you only use a syncing account with NetNewsWire, you may want to hide or disable the On My Mac account.
|
||||
|
||||
|
||||
### Hide the On My Mac account
|
||||
|
||||
To hide the On My Mac account, place the mouse over the **On My Mac** listing in the sidebar and click on **Hide**.
|
||||
|
||||
|
||||
### Disable the On My Mac account
|
||||
|
||||
Disabling the On My Mac account can be done in NetNewsWire’s preferences.
|
||||
|
||||
1. Open the NetNewsWire preferences from **NetNewsWire → Preferences…** (⌘-,)
|
||||
2. Click on **Accounts** and select *On My Mac*
|
||||
3. Deselect the *Active* tick box
|
||||
|
||||
You’ll no longer see the On My Mac account in the NetNewsWire sidebar.
|
||||
@@ -1,16 +0,0 @@
|
||||
@title NetNewsWire and your privacy
|
||||
|
||||
# NetNewsWire and your privacy
|
||||
|
||||
[The NetNewsWire Privacy Policy](https://github.com/brentsimmons/NetNewsWire/blob/main/Technotes/privacypolicy.markdown)
|
||||
|
||||
NetNewsWire has a very strict privacy policy – we don’t want any private information about you.
|
||||
|
||||
The only data we collect about how you use NetNewsWire, *only if you agree and opt in*, is crash logs.
|
||||
|
||||
|
||||
|
||||
Changes to the Privacy Policy
|
||||
-----------------------------
|
||||
|
||||
The [full privacy policy](https://github.com/brentsimmons/NetNewsWire/blob/main/Technotes/privacypolicy.markdown) is stored in the NetNewsWire GitHub repository, where you can track any changes we might make.
|
||||
@@ -1,47 +0,0 @@
|
||||
@title How to go through your articles
|
||||
|
||||
# How to go through your articles in NetNewsWire
|
||||
|
||||
NetNewsWire was built to make it easy to read your articles one-handed. This is perfect for when your other hand is occupied with a warm drink or an insistent furry friend.
|
||||
|
||||
One-handed reading is accomplished with keyboard shortcuts. NetNewsWire’s shortcuts are special because they only require pressing *a single key*.
|
||||
|
||||
(For a full list of keyboard shortcuts, including Command (⌘) key alternatives, see the [Keyboard Shortcuts](keyboard-shortcuts.html) help page, or use **Help → Keyboard Shortcuts** in NetNewsWire.)
|
||||
|
||||
|
||||
|
||||
Use the Space bar
|
||||
-----------------
|
||||
|
||||
The easiest way to read articles in NetNewsWire is using the **space bar**.
|
||||
|
||||
If you’re reading an article that can be scrolled, pressing **space bar** will scroll it – just like it would in Safari. If you’re at the end of the article, **space bar** will take you to the next unread article.
|
||||
|
||||
|
||||
|
||||
Go to Next Unread
|
||||
-----------------
|
||||
|
||||
Sometimes you may want to skip reading an article entirely – that’s totally fine! Rather than press space bar multiple times, you can jump directly to the next unread item by pressing ⌘-/ or just press **n** or **+**.
|
||||
|
||||
If you want to skip the article for now, but plan to come back to it later, the **m** key is for you. Pressing it will mark the current article as unread and then go to the *next unread* item.
|
||||
|
||||
|
||||
|
||||
Moving around lists
|
||||
-------------------
|
||||
|
||||
You may not always want to read linearly – imagine there’s a new article on [Julia Evans’](https://jvns.ca) site you want to read first. You still don’t need to leave the keyboard.
|
||||
|
||||
Pressing the left and right arrow keys will move you between the three panes in the NetNewsWire interface. Those panes are, from the left, the subscriptions list (sidebar), articles list timeline (centre pane) and the full article detail pane (right). The selected item’s highlight colour gives you a hint to which pane is active.
|
||||
|
||||
In the subscription and article lists, the up and down arrow keys will change the currently selected item.
|
||||
|
||||
|
||||
|
||||
Marking as read or unread
|
||||
-------------------------
|
||||
|
||||
As you zip through the NetNewsWire interface, you may want to mark an article as read or unread. The easiest way to do this is use the **r** and **u** keys, respectively.
|
||||
|
||||
Again, see the [Keyboard Shortcuts](keyboard-shortcuts.html) help page or **Help → Keyboard Shortcuts** in NetNewsWire for a full list of keyboard shortcuts.
|
||||
@@ -1,36 +0,0 @@
|
||||
@title Installing and using the Safari Extension to add feeds
|
||||
|
||||
# Installing and using the Safari Extension to add feeds
|
||||
|
||||
NetNewsWire provides a Safari Extension which adds a *Subscribe to Feed* button to your Safari toolbar. This allows you to quickly add a site’s feed without entering an address manually into NetNewsWire.
|
||||
|
||||
|
||||
|
||||
Installing the NetNewsWire Safari Extension
|
||||
-------------------------------------------
|
||||
|
||||
The Safari Extension is installed automatically with NetNewsWire. However, it must be *enabled* before you can use it.
|
||||
|
||||
You will enable the extension in Safari:
|
||||
|
||||
1. Open Safari
|
||||
2. Click on the **Safari** menu and select **Preferences…** (⌘-,)
|
||||
3. Click the **Extensions** panel
|
||||
4. From the list, click the checkbox beside **Subscribe to Feed** to enable the extension
|
||||
5. Close the Preferences window
|
||||
|
||||
Once this is done, the *Subscribe to Feed* button will be added to your Safari toolbar.
|
||||
|
||||
|
||||
|
||||
Adding a feed using the Safari Extension
|
||||
----------------------------------------
|
||||
|
||||
For any site that advertises its feeds, you can use the ‘Subscribe to Feed’ button. Clicking it send the feed’s address to NetNewsWire where you can set options like an alternative feed name, and the account and folder where it will be stored.
|
||||
|
||||
|
||||
### What to do if the ‘Subscribe to Feed’ button is greyed out and disabled
|
||||
|
||||
The *Subscribe to Feed* button will only be enabled for sites that advertise their feeds in their code. If the button is disabled, NetNewsWire wasn’t able to find any feeds automatically.
|
||||
|
||||
You may be able to find a feed manually by visiting the site. There, look for a link to an RSS, Atom or JSON feed. If one exists, you can [add this URL to NetNewsWire directly](adding-feeds.html). Right-click on the link and copy the URL to paste into NetNewsWire.
|
||||
@@ -1,13 +0,0 @@
|
||||
@title Sorting the NetNewsWire timeline
|
||||
|
||||
# Sorting the NetNewsWire timeline
|
||||
|
||||
The NetNewsWire timeline is the list of articles shown in the centre pane.
|
||||
|
||||
« Screenshot »
|
||||
|
||||
By default, this list displays newer articles at the top.
|
||||
|
||||
You can change the sorting for the timeline in the View menu: **View → Sort by → Newest Article on Top** or **Oldest Article on Top**.
|
||||
|
||||
This setting applies to all feeds and can be changed anytime.
|
||||
@@ -1,28 +0,0 @@
|
||||
@title How to Update NetNewsWire
|
||||
|
||||
# How to Update NetNewsWire
|
||||
|
||||
NetNewsWire can check for and install updated versions of itself. This can be done for you automatically in the background or you can check for updates manually.
|
||||
|
||||
|
||||
|
||||
Automatic checks for updates
|
||||
----------------------------
|
||||
|
||||
When you first launch NetNewsWire you’ll be asked whether it should periodically check for updates. You will be notified of any new updates and can choose to update when you’re ready.
|
||||
|
||||
|
||||
|
||||
Manually checking for updates
|
||||
-----------------------------
|
||||
|
||||
You may have declined automatic checks for updates or just [read about a great new update](netnewswire-news.html) and want to download it now. You can always check for updates manually by selecting **NetNewsWire → Check for Updates…** from the menu bar.
|
||||
|
||||
If a new update is found, NetNewsWire can download and install it for you.
|
||||
|
||||
|
||||
|
||||
Privacy
|
||||
-------
|
||||
|
||||
When checking for updates, whether automatically or manually, no personally-identifiable information is collected – not even an anonymous system profile. For more information about your privacy and NetNewsWire, please see the NetNewsWire Privacy Policy.
|
||||
@@ -1,47 +0,0 @@
|
||||
@title Where NetNewsWire data is stored
|
||||
|
||||
# Where NetNewsWire data is stored
|
||||
|
||||
NetNewsWire remembers your feeds and article read status, as well as your account information and preferences. This information is stored in two different locations on your Mac, but separately from the NetNewsWire app.
|
||||
|
||||
|
||||
|
||||
Preferences file
|
||||
----------------
|
||||
|
||||
Your NetNewsWire preferences file is called `com.ranchero.NetNewsWire-Evergreen.plist`. It’s stored in your account’s Preferences folder, which can be found in the Finder by navigating to:
|
||||
|
||||
*Your home folder* › Library › Preferences
|
||||
|
||||
|
||||
### Preferences caching
|
||||
|
||||
The contents in the preferences `plist` file are cached by macOS. If you make any changes or delete the file, log out and log back in before relaunching NetNewsWire to make sure the old settings are fully cleared. (Alternatively, if you prefer, you can also run `killall cfprefsd` from Terminal to reload the preferences cache.)
|
||||
|
||||
|
||||
|
||||
Feeds and accounts data
|
||||
-----------------------
|
||||
|
||||
Information about your subscribed feeds, article read status and accounts (On my Mac and Feedbin) are stored in your account’s Application Support folder. This can be found in the Finder by navigating to:
|
||||
|
||||
*Your home folder* › Library › Application Support › NetNewsWire
|
||||
|
||||
|
||||
### Exporting your feeds
|
||||
|
||||
If you just want to export your list of subscribed feeds, NetNewsWire [can export an OPML for you](export-opml.html).
|
||||
|
||||
|
||||
|
||||
Resetting or removing NetNewsWire
|
||||
---------------------------------
|
||||
|
||||
If you are running into problems while using NetNewsWire, you may want to reset your settings. By removing the files and folders above you can start over again from scratch.
|
||||
|
||||
You may also want to delete these files if you want to completely remove NetNewsWire from your Mac.
|
||||
|
||||
|
||||
### Can’t find the Library folder?
|
||||
|
||||
If you can’t see the Library folder in the Finder, you can open it by holding down the Option (⌥) key and clicking **Go → Library**. For more information, see the [Library folder](https://support.apple.com/en-gb/guide/mac-help/aside/mh35934/10.14/mac/10.14) note in the macOS Documentation.
|
||||
@@ -1,25 +0,0 @@
|
||||
# Help Menu
|
||||
|
||||
_Brent Simmons, 27 May 2017_
|
||||
|
||||
## Help Book
|
||||
|
||||
I considered doing a Help book that ships in the app bundle, which is the traditional and Apple-endorsed way to go.
|
||||
|
||||
But instead the Help book will go on the web, at `http://ranchero.com/evergreen/help/[version_number]`.
|
||||
|
||||
This gives me the ability to update the Help book whenever it needs it — to answer a frequently-asked question, for instance. It means that if someone asks me a question already answered in the Help, I can respond with a URL.
|
||||
|
||||
That it also makes the downloadable .zip file smaller is nice, but not a major consideration.
|
||||
|
||||
## Add Evergreen News Feed
|
||||
|
||||
The Evergreen news feed is a default news feed. It’s entirely possible that a person will delete it, though, and then later want to get it back. That’s what this command is for.
|
||||
|
||||
## Other Help menu items
|
||||
|
||||
Evergreen is free and open source, and I don’t have time to provide support *and* work on the app itself. So there is no email-support menu item.
|
||||
|
||||
However, there are links to the website, GitHub repository, and GitHub bug tracker. Anybody with a GitHub account can report bugs and make feature requests.
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 20 KiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,42 +0,0 @@
|
||||
# What’s New in Cocoa - WWDC 2018
|
||||
|
||||
https://developer.apple.com/videos/play/wwdc2018/209/
|
||||
|
||||
- NSImage(named: string) is now allowed!
|
||||
- NSMenuItemValidation is now a real protocol, other informals have been made real
|
||||
- Secure coding with NSKeyedArchiver, unarchiver
|
||||
|
||||
- NSColor.controlAccentColor
|
||||
- .withSystemEffect - pressed, disabled, etc.
|
||||
- Content Tint Color
|
||||
- NSButton, NSImageView contentTintColor
|
||||
|
||||
### Layer Backing
|
||||
- Not one to one NSView to CALayer (unlike UIKit)
|
||||
- No need to set .wantsLayer = true
|
||||
- Use NSView draw method instead of layer drawing
|
||||
- Fine to implement updateLayer along with draw method
|
||||
- .wantsUpdateLayer is okay
|
||||
- Don’t use NSView lock/unlock focus
|
||||
|
||||
### User Notifications
|
||||
- NSUserNotification deprecated
|
||||
|
||||
### NSToolbar
|
||||
- centeredItemIdentifier
|
||||
- Auto layout now used when min max sizes not specified
|
||||
|
||||
### NSGridView
|
||||
- Grid views authored in IB work in 10.13
|
||||
|
||||
### NSTextView
|
||||
- fieldEditor
|
||||
- scrollableTextView
|
||||
- etc.
|
||||
- performValidatedReplacement - calls delegates properly, fills in atts from typing atts
|
||||
- May need to call setSelectedRange first to get proper atts
|
||||
- validRequestor - Services API
|
||||
|
||||
### Custom Quick Actions
|
||||
|
||||
|
||||
@@ -1,17 +0,0 @@
|
||||
# Questions Answered
|
||||
|
||||
#### How do I delete a feed?
|
||||
|
||||
Select it in the sidebar, then hit the Delete key. Or choose Edit > Delete from the menubar.
|
||||
|
||||
Note: you can delete multiple feeds, and you can delete folders. You can also undo if you change your mind.
|
||||
|
||||
#### Why does NetNewsWire require the latest macOS?
|
||||
|
||||
Since NetNewsWire is a nights-and-weekends project, we don’t have enough time to run and test on older versions of macOS. Most of the time it will require the most recent macOS.
|
||||
|
||||
#### Why is Feedbin syncing planned for 1.0 but _____ isn’t planned until 2.0?
|
||||
|
||||
This was a difficult decision. We didn’t want to ship with no syncing at all, but we also didn’t want to delay shipping until we’ve done a whole bunch of systems.
|
||||
|
||||
So we chose Feedbin, since that’s what we use, and since the folks at Feedbin have been friendly and helpful.
|
||||
Reference in New Issue
Block a user