“Pinboard” is the best option that was suggested. (“Shelf” which is a close second is not correct because “shelving” means to put aside for later. See how JetBrains correctly uses the term Shelve and unshelve changes | IntelliJ IDEA)
Edit: to be clear, the main problem is the keyboard shortcut Toggle Contents in sidebar which specifically looks for the contents.md page and creates it if it doesn’t exist. contents.md may also have other special status in other places (e.g., the :default-home setting which seems to treat it specially)
Contents suggest they’re the inner parts of something. So I was thinking it meant that I was looking at the inner parts of a block or page or something. Very misleading
It was addressed and correctly archived. That request refers to the previous Logseq UI with no Favourites in the left sidebar and with Contents.md displayed in the right sidebar but labeled “Favourites” and this created confusion and the request to rename Contents.md to Favourites.md.
Logseq devs addressed this by introducing Favourites as a list of pages in the left side bar and rename the label in the right sidebar “Contents”.
I don’t think it works the way you think it does. Did you try it?
:default-home {:page "Test", :sidebar "pinboard"} doesn’t work for me, but :default-home {:page "Test", :sidebar "Contents"} does even though I have both pages.
Either way, I don’t think this is relevant. This setting specifies what you want open at startup time. It says nothing about the keyboard shortcut Toggle Contents in sidebar which specifically looks for the contents.md page and creates it if it doesn’t exist. This is the meaning of this thread but I will edit the OP for clarity.
Until this keyboard shortcut is changed (both in name and in the automatic creation of a contents.md) and other places in the code where contents.md is treated specially (e.g., the :default-home setting above), this issue is not addressed and IMO the original post was incorrectly archived.
Found this thread after following the exact same train of thought as @huy. Contents is in the sidebar, together with the graph, and named as if it applies to any page… but it’s actually a normal page that I have to edit? And actually it’s also not a normal page anyway because its name is special and used in the keyboard shortcuts?
I don’t specially like “Pinboard”, but at least that’d be clearly a different thing to the “contents” pane present in the sidebar of many IDEs / text editors / PDF readers!
Well, I expected it to fill itself, possibly as my main note get its header structure - which is how the contents/outline pane works in IDEs like Eclipse / VSCode / IntelliJ, text editors like Google Docs / Word /LibreOffice / Pages / BBEdit, probably every PDF reader in existence, etc.
I just assumed it wasn’t working in Logseq because of some missing configuration or yet another bug / missing feature.
Other applications need it because they are not outliners. In Logseq you can just collapse all the blocks in the current page with a shortcut and see a overview of its structure. It’s up to you to eventually use headers, but those are an aesthetic thing in Logseq. This way when you export to Markdown you cam get rid of the outliner structure and keep the headers, that other applications will consider as the structure. In a certain sense Logseq can be used as a framework to produce Markdown files, in fact you can export not only the whole page, but also starting from whatever block you want. In Logseq a page is more fluid, it can contain more “documents” structured with headers. You have to think the outliner UI as a mix of folder structure and document structure. So it doesn’t make sense to extract the “Contents” of a page using the headers, but if you really need it, there is a plugin.
Instead the actual Contents.md refers to the whole graph, not the current page.
Yep, I understand now - but I had to find this thread to understand. Which is why I also think that naming that non-auto-filled page “Contents”, and putting it together with the auto-filled graph, makes little sense.
The app could make it clearer for sure, but to use Logseq at the moment you are supposed to check the documentation at https://docs.logseq.com that features the Contents.md as its home page.
I registered specifically to say that I feel like I’m on crazy pills reading about the fact that the thing that couldn’t be named Contents for the purpose that it’s supposedly serves is actually was designed to serve that exact purpose and indeed was called Contents, intentionally.
No rational person would have made this kind of connection. I’m at the loss of words that someone actually decided to call a Pinboard, a Scratchboard, CONTENTS. Honestly, I feel like I’m playing a role in Truman Show, I literaly can’t believe that there are multiple threads of people trying to make sense into the thin air and the response is, apparently, “it’s serving its purpose”. If the purpose is to make people confused, or is merely a tool to trick people into registering on this forum, then the author clearly did everything correcly, because I don’t remember myself being this flabergasted at something so trivial in years.
Logseq being an open source project, you’re free to suggest changes and make a pull request (or just roll your own custom build). Or just follow the suggestions in this thread. I mean, if the name “Contents” is causing you so much pain…
The name Contents comes from the fact that you can disable the Journals page and define a static homepage to load when starting Logseq. By default this is the (Table of) Contents page (Alex even explained it in the post above yours).
You have to realize that Logseq was started by a group of people whose native language isn’t English. Yet, they’re still making an effort to create a free tool in as many languages as possible. Personally, I’m grateful for that even though “Contents” might not be the best name for a personal index or table of contents.
I agree it would be nice if it were possible to rename the Contents page to anything you like. But as you rightly point out, it’s a trivial thing and there are bigger fish to fry at this moment.
Sorry if I sound salty, but I wanted to give some pushback by providing context. Also, we want to keep this a friendly place so please don’t speak like this about people who put long hours and tons of energy into creating a free and open source tool for our benefit.
