Moving over to a Trilium instance for documentation?

[eliandoran]

@meichthys , @Alumniminium , now that there is PikaPods, I think we can consider moving the documentation over to a shared instance of Trilium with only a few people having edit access. The public will be able to access it via the share API; what's your take on it?

I think there are a few blockers that we might want to address before:

• The default share theme is not very user-friendly. I think @zerebos wanted to contribute upstream to Trilium Notes an improved share theme but I'm not sure if he had the time to do it.
• The URLs are not very user-friendly because the note IDs are randomly generated. It might be interesting to allow the user to define custom friendly URLs for shared notes, but it would involve a bit of development.

cc. @maphew

[maphew]

theme: +1. and work on making theming easier to change and apply will be welcome for all users anyway.

Friendly urls: perhaps a script with button/keystroke for "turn title into share-alias". One better: it's actually the default on save, but only acts if #shareAlias is missing/empty. In case of duplicate append something.

url generally: How does trilium.rocks bare domain serve shared pages? There's no share/ prefix. And then how does one get to the edit interface? (I'd like to do the same at my domain, but the bare url is a login prompt). Also see https://github.com/orgs/TriliumNext/discussions/494

[maphew]

re: default on-save: that idea would add needless performance hit. Better to tie it to "when shared" slider which is a one time or at least user initiated thing.

[meichthys]

I'm 100% in favor of this. It would make the editing of the docs MUCH easier than the github flow. I think the recent changes would be sufficient to track changes, and we can always take manual backups if needed.

Although the default share theme isn't amazing, it is probably on-par (or better) than our existing github pages documentation which has no sidebar with a table of contents and very poor navigation.

The custom urls would definitely be nice, but I don't think it should be a blocker.

We would incur some minor financial costs for hosting this unless perhaps PikaPods could do us a favor and host it for us? @maphew do you know if this might be a possibility? In order to make it mutually beneficial, I don't see why we couldn't add something to our docs that indicates that we are hosted on PikaPods(?)

[maphew]

I agree that none of the items listed so far are blockers.

On Pika hosting: since I already have a dialogue with I'll ask them about it.

[m3nu]

You guys are welcome to run as many pods you need for free on our platform. For demo, docs, etc.

[eliandoran]

@maphew ,

Friendly urls: perhaps a script with button/keystroke for "turn title into share-alias". One better: it's actually the default on save, but only acts if #shareAlias is missing/empty. In case of duplicate append something.

An important aspect is that changing the friendly URL cannot be done automatically, because the user might not be aware that changing the title will also affect the URL. Generally once a page is published it's a good idea to keep the URL the same in order not to break any hard links (inside the application, or bookmarked by viewers of the site).

url generally: How does trilium.rocks bare domain serve shared pages? There's no share/ prefix. And then how does one get to the edit interface? (I'd like to do the same at my domain, but the bare url is a login prompt). Also see https://github.com/orgs/TriliumNext/discussions/494

Most likely it's simply a reverse proxy configuration. Whenever the domain is accessed, it proxies the URLs to a local instance with the share/ prefix. Of course, this is only an assumption, but it's most likely.

[eliandoran]

You guys are welcome to run as many pods you need for free on our platform. For demo, docs, etc.

@m3nu , your help is much appreciated.

I will create an account and create a pod to manage the documentation as a proof of concept. We'll later see with the rest of the team what they think about it.

[maphew]

An important aspect is that changing the friendly URL cannot be done automatically, because the user might not be aware that changing the title will also affect the URL.

Agreed, the auto apply of shareAlias only happens once, and after that is only changed by a deliberate user act and not by the system.

[eliandoran]

@Alumniminium , @meichthys , please reach out to my via an email to contact@eliandoran.me in order to share credentials.

[perfectra1n]

I worked with Zerebos to set up some documentation on how to set up the share theme here, and I've uploaded the "full" set of Notes required to use the theme here along with some instructions. It works super well, I love the theme :)

[Alumniminium]

Sent the mail, sounds perfect. I'm all for it.

[eliandoran]

@perfectra1n , wonderful job.