At present links to documents are supported but only to the whole document. It would be nice to link to a specific heading either in the same document or another document.

How to do it in Docusaurus Docusaurus allows this by adding a code to the (destination) heading {#...} and then including that code in the link. For example, see https://manual.paratext.org/Training-Manual/Stage-1/OD

In chapter 2 under 2.3 Create a new text layout I have a link to section 2.5 ... ≡ Paratext menu, under (Paratext > Open, select several resources, choose to open as Text collection. See [2.5]

Heading 2.5 is coded as: ### 2.5 Open resources in a Text collection {#25} The link is coded as: See [2.5] (/Training-Manual/02-Stage-1/2.OD.md#25) (the link is broken to display the coding)

Note: I have the code without decimal points otherwise it didn't work reliably.

Docusaurus documentation see https://docusaurus.io/docs/markdown-features/toc#example-subsubsection-1-a-ii for a discussion on setting an explicit heading id.

Describe the bug What is the best way to add links?
If I add the link in Notion then when I click on the link it takes me to the Notion file not the webpage. I have many links in my project which worked well in raw MD files but my conversion process (Word add-in) has hard-coded them to a file on my c: drive so I need to replace them.

** Reproduction Steps ** Goto https://sillsdev.github.io/paratext-manual/Overview/ Click on link to the right of the chapter name (e.g. 1.Intro) The notion page opens.

URL of a source Notion page that, when docu-notion accesses or converts it, shows the problem: https://jennibeadle.notion.site/00-Overview-3ce84f9ca3264aed8532489c0574f95c (see links in Introduction)

At least one of these:

1. URL of a docusuarus site showing the resulting page https://sillsdev.github.io/paratext-manual/Overview/ (see links in Introduction)

Expected behavior When I click on the link on a page I expect to go to the appropriate page on the website. So if I clicked on 1.Intro I expect to go to https://sillsdev.github.io/paratext-manual/288f2a75-e689-4ec7-98f8-17f982c15e17/ not the Notion page.

Screenshots If applicable, add screenshots to help explain your problem.

Choose the link

Expected result

Actual result

Additional context Add any other context about the problem here.

Describe the issue Docusaurus uses the folder names (short with hyphens) for the sidebar dropdowns unless you add category.yml files to each folder to specify the name of the folder. These are also used to translate the folder names.

See discussion on Category item metadata in https://docusaurus.io/docs/sidebar/autogenerated#category-item-metadata

Describe the bug Docu-notion doesn't output all the front matter to MD. The top of page heading "Notion title" is used as the filename and title. The front matter has a separate title field but the export replaces whatever is in that field with the top of page heading. My goal is a short filename (for URL) with a longer title (for sidebar).

Reproduction Steps

URL of a source Notion page that, when docu-notion accesses or converts it, shows the problem: https://jennibeadle.notion.site/0-0-3-4eed40af381f4fb8b455246b3bae0c7c

At least one of these:

1. URL of a docusuarus site showing the resulting page Desired result: https://manual.paratext.org/Video-summaries/Introduction/0.2.Navigation/0.0.3 Notion result: https://sillsdev.github.io/paratext-manual/4eed40af-381f-4fb8-b455-246b3bae0c7c/ (note title displayed was copied to the document for later editing)

Expected behavior The text in the title field of Notion document front matter, will replace the Notion document "title".

Screenshots If applicable, add screenshots to help explain your problem. Desired result

In Notion (showing front matter)

Docu-Notion website (showing short title not title from frontmatter) (Note the ---title ... was copied to add after next process)

Additional context Unfortunately, the Actions don't give me a file that I can tweak.

This change is 

BREAKING CHANGE: Makes changes to the expected css for formatting columns. So clients must make those changes to their respective css files to get the desired results.

This works around a bug in notion-to-md and allows us to handle simple numbered lists. It will not handle lists that are continued after other content.

If you use Docusaurus's auto-generated sidebar, it orders categories alphabetically:

Notion:

Docusaurus site:

So while we currently get the order of individual pages correct (using sidebar_position), we don't have a way of also controlling the order of the categories .

If docu-notion could generate the sidebar itself, then sites could use that to match the order of categories in the Notion source outline.

docu-notion makes this into

 <li parentName="ol"><strong parentName="li">{`Dropbox`}</strong>{` will ask whether you want to “Remove `}<book title>{` from your Dropbox account and all devices?” Click “Move out of Dropbox”. If you do not want to see such notices in the future, you can tick the box “Don’t ask me this again”.`}</li>

Instead, the text should be encoded so that it doesn't mess up the html parser. Q: what if there is content in there that we do want to be parsed?

The generated side bar is showing dashes in place of spaces from the page titles on Outline pages:

Actual documentation pages are fine:

www.notion.so/hattonjohn/docs-bloomlibrary-org-043c6aa5842946bdbea3a4f37c97a0e7 https://docs.bloomlibrary.org/

Notion has Callouts, and you can set the icon of them. But there is no way to set the color.

Let's map 5 of these icons to their equivalent Docusaurus Admonitions.

Then you can make a callout, set its icon, and get the fully styled admonition equivalent.

We should leave the previous version of the document in place if the current version has a Status that is not Publish.

This will require not deleting the destination docs directory, and that will require that we notice what documents are no longer in Notion at all, so that we can delete them.

Describe the bug The search add-in only finds results when used from the front page (intro page with slug /) and only hits on that page.

** Reproduction Steps **

• Go to the intro page

• Click in the search box

• Type a word

  • only finds words on that page.

• Go to another page

• Click in the search box

• Start to type a word

• No results error

URL of a source Notion page that, when docu-notion accesses or converts it, shows the problem:

URL of a docusuarus site showing the resulting page https://sillsdev.github.io/paratext-manual/00-list-of-features/

Expected behavior Expect to get results from all the pages.

Screenshots Screenshot shows no result even when several results clearly seen on page

Additional context I checked the docusaurus.config.js and removed the comment on languages for the plug-in. It looks identical to my other working site.

Describe the bug Links in either numbered lists or callouts are not converted by docu-notion.

Reproduction Steps In Notion

• Create a numbered list block
• Insert a link (to a https address)
  • Link is displayed in Notion

Do a Release

• Result has no link

URL of a source Notion page that, when docu-notion accesses or converts it, shows the problem: https://jennibeadle.notion.site/5-BC1-Basic-checks-9a9d6657a78c4dacaaae3a1af028df41 (See just before 5.2 - I tested :::tip ...:::, callout, numbered list, and quote)

URL of a docusuarus site showing the resulting page https://sillsdev.github.io/paratext-manual/05.BC1/

Expected behavior Obviously, I expect to have a link to click on (as shown in Notion)

Screenshots Various blocks Admonitions - Markdown works, quote works but callout and numbered list don't convert.

Manually Numbered lists work Appendix is a text block with manual numbered and works.

Describe the bug Numbered lists restart at 1 after subheading even when given a specific starting number after the heading. Having just looked at the Notion markdown, I think it may be a Notion bug not a docu-notion bug.

Reproduction Steps I have 25 chapters in my Paratext Manual. In the overview I break them up into sections but need the sequential numbering to continue so it shows correct chapter number. Add a numbered list with headings. Edit each list item after the heading with the number to continue. Notion displays correctly. But the resulting page restarts the numbering.

URL of a source Notion page that, when docu-notion accesses or converts it, shows the problem: Notion: https://jennibeadle.notion.site/Overview-of-Training-Manual-3ce84f9ca3264aed8532489c0574f95c Resulting page: https://sillsdev.github.io/paratext-manual/Overview/

Expected behavior Numbering should continue (as per my other Docusaurus site. https://manual.paratext.org/Training-Manual/Overview

Notion markdown The notion markdown still has 1.

### Stage 1 Drafting

1. 2. **[OD** – Organising your desktop](https://sillsdev.github.io/paratext-manual/2.OD)
2. **[PP1** – Project plan and progress](https://sillsdev.github.io/paratext-manual/3.PP1)

I added the 2. to specify to continue from 2 but it still has the 1. I corrected the markdown and pasted it again but it added the 1. again.

Screenshots In Notion: showing the continuer set

Result of Docu-notion (showing restart as 1):

Site using Markdown (sequential):

Additional context I searched for possible solutions. https://stackoverflow.com/questions/18088955/markdown-continue-numbered-list/22138846#22138846 suggested putting a blank link before the element (in their case a code block) but had no effect.

Describe the bug Synced blocks that are linked to the original are not rendered. The original synced block is rendered.

** Reproduction Steps **

https://www.notion.so/metapages/Facts-mermaid-63f6f281a33649cc9dfabb86d26ad829

The first mermaid diagram is not a synced block, and renders fine.

The second block is a synced block, and renders fine in this page, but another page has a linked to that synced mermaid block:

https://www.notion.so/metapages/Introduction-to-docu-notion-779f83504bd94642a9b87b2afc810a97

Expected behavior Linked synced blocks show the exact contents of the original synced block

Screenshots If applicable, add screenshots to help explain your problem.

Additional context Add any other context about the problem here.

Fixes #28

I use mermaid diagrams with clickable link to other notion documents:

You can click on "An internal page" and it takes you to another notion document.

This PR adds some config and processing to get those internal mermaid URLs working with docu-saurus.

I tried to make a CodeTransformer in the same pattern as the other transformers, but it didn't have the right context for getting the links path to the notion documents, so I just added a link processor.

The result is the same mermaid diagrams but the links correctly link to docusaurus pages:

You can then click the first node and you go to another page.

There is an extra config flag, I was not able to figure out how to align the different docusaurus root documents you can specify (e.g. ./docs, ./blog), with the docu-notion->saurus step, so some experimentation may be needed to align the paths and the slugs.

This change is 

Background Side-by-side presentations of text and images are more effective in training presentation contexts. The texts accompanying images frequently require less vertical space than the images.

Problem

• Images in columns that are not equal-width are rendered full-width in PDF output. (Images in one of two equal-width columns are rendered properly.)

Desired behavior Respect the column widths specified in the Notion authoring environment in PDF output.

Screenshots Notion editing environment: PDF output: