Reference Commands

Monday, February 20, 2023

7:46 AM

Table of Contents [Refresh]

────────────────────────────────────────────────────────────────────────────────────────────────

Two-Way Linking

Create a two-way link between two selected words or phrases, either across pages or on the same page. This makes it easy to navigate back and forth between two points in your content. This is invoked as two commands, the first to bookmark the first word or phrase and the second to select and create the link with the second words or phrase.

Bookmark

Select a word or phrase in a one paragraph as an anchor point and run the Bookmark command. Complete the linking by running the Two-Way Link to Bookmark command.

Two-Way Link to Bookmark

Once a bookmark is set, select a second word or phrase within a different paragraph on the same page or a within a paragraph on a different page and run Two-Way Link to Bookmark. The anchor phrase is hyperlinked to the final phrase and vice versa.

Link References To This Page

This is an automated approach to bidirectional linking based on the title of a page. It discovers all mentions of the title of the current page on other pages and creates bi-directional reference links between the two. Also, a Linked References index is appended to this page with links back to all referring pages. If the current page title is prefaced with emojis or has a date prefix of the form yyyy-mm-dd then those parts are ignored and the remainder of the title is used to search for back references.

Clicking the [Refresh] link next to the Linked References index will rescan pages and rebuild the paragraph.

This uses the built-in OneNote search engine. This engine is notoriously inaccurate. If you know there are pages that reference this page but they are not included in the Linked References index then consider either using the Include unindexed pages options or rebuilding the Windows Search index or deleting the OneNote cache.

Refresh Page References

After changing the name of a page that is referenced by other pages, this command will update the hyperlinked text on those referring pages with the new title of the current page. See the note above about the OneNote search engine.

Footnotes

Footnote are limited to on-page references. OneMore keeps track of footnotes and will automatically reorder them to keep them numbered sequentially from the top of the page. If you delete a footnote, it again will renumber the remaining footnotes so there are no numbering gaps.

Add Footnote

Default shortcut is Ctrl + Alt + F

You can add a footnote anywhere on the page and a reference label is inserted at the current cursor location and a footnote is added to the bottom of the page. You can then edit the text in that footnote to your heart's desire. Text colors are based on the page background color.

Footnotes

Note that footnotes are hyperlinked so you jump from the content body down to the text of a footnote or back up again to the content that references a particular footnote.

Note also that you cannot use hard carriage returns within the text of a footnote (Enter). Instead, use soft carriage returns (Shift+Enter) to insert line breaks and empty lines.

Refresh Footnotes

Refreshes all footnote references on the page so their numbers are sequential on the page. This is useful when moving content up or down the page.

Remove Footnote

Default shortcut is Ctrl + Shift + F

And if you no longer want a footnote, place the cursor over the label or over the footnote text at the bottom of the page and click the Remove footnote command. Voila!

Additional Reference Commands

Check URLs

Validates each URL on the current page and highlights invalid URLs with a red background.

Create Page Map

Generates a report showing all pages that contain links to other pages. This can be scope to the current section, current notebook, or all notebooks. The report is produced as a new page in the current section.

By default, links are scanned within the chosen scope, e.g. just the current section. If you want to include links beyond the current scope, check the Include cross-notebook references checkbox. Depending on the number of pages and notebooks, this can be time consuming.

Embed

There are times when you have a snippet of content that you want to repeat on other pages. The Embed command copies and synchronizes selected contents of a specific source page into the current target page at the cursor location. The embedded content is wrapped in a single-cell table with a visible border to indicate that it is embedded content. Click the [Refresh] link in the upper right of the table cell to refresh the embedded contents and synchronize with any changes from the source page.

There are two ways of identifying the source content. The first is to bookmark a specific paragraph that you want to embed. The second is to mark the start and end of the content using custom tags in your source page.

By Bookmark

If you want to embed one entire paragraph, you can mark that paragraph using the Bookmark command. Once marked, go to the target page and run the Embed command. The Embed Options dialog box is displaying, showing the beginning of the paragraph, along with options for how that paragraph is displayed on the target page.

By Custom Tags

start_

Custom tags are nothing more than a bit of text that you define and type into your source page. It's best if you use one unique tag to markt the start of the content and another unique tag to mark the end of the content, for example start_ and _end just like the custom tags around this paragraph. The tags themselves will not be copied, just the content between them. If you don't specify tags, the entire first Outline on the source page is embedded in the target page.

_end

Once the tags are in place, indicate the source page, by using the OneNote Copy Link to Page command - right-click a page in the page navigator panel. Or, you can use Copy Link to Paragraph by right-clicking any paragraph on the source page - which paragraph is irrelevant; we're just picking the page with this action. If you don't have a link to a page on the Clipboard, you will be prompted to select a page from your notebooks.

Once the source page is identified, you'll be shown the Embed Options dialog that asks for start and end delimiters. Leave them blank to embed the entire first Outline, or specify the start and end tags that specify the boundaries around the content you want to embed.

second_

You can mark multiple areas of your page that can be embedded in other pages, as long as each area has its own unique pair of delimiters.

_second

See also the embed --refresh CLI command.

Note, the Embed command does not probe for chained or recursive references. If page A embeds content from page B and page B embeds content from page C, you could end up with embedded content that is out of sync depending on which page you refresh first. And if page A embeds content from page B and B from A, where one of them pulls in the embedded content from the other, then they will almost always be out of sync!

Insert QR Code

Converts selected text to a QR code and inserts the QR image into a new paragraph following the selected text. QR codes provide a convenient way to share passwords, Web addresses, any other data (up to 2000 characters).

Replace URLs with Images

Replaces all or selected hyperlinked URLs that reference online images with those referred image. If the image cannot be downloaded, no changes are made. This will only affect URLs where you can read the Web address on the page; it skips URLs where the text differs from the actual address.

Replace URL TItles with Addresses

This is the opposite of the Replace URLs with Web Page Titles command, in that it removes the Web page title and restores the original Web address as the text of the hyperlink.

Replace URLs with Web Page Titles

Automatically replaces all or selected hyperlinked URLs with the <title> specified on the associated Web pages. This only affects URLs for which the displayed text is the same as the link address, meaning if you've already customized the displayed text, OneMore will not alter your changes.

For example, given this URL on a OneNote page: https://github.com/ it would be replaced with its hyperlinked title: GitHub

#omwiki #omcommands

Please consider a sponsorship or one-time donation to support ongoing development

Created with OneNote.