Home Assistant Cookbook - Discussion Thread

Any one know how to link to internal anchors within a post?

The cookbook index is getting quite long, and I was hoping to put a mini index at the top linking to the main headings, but I can’t make it work.

The Discourse docs suggest that anchors should be generated automatically by markdown headings (which they are). I can get a link like:

https://community.home-assistant.io/t/the-home-assistant-cookbook-index/707144#configuration-4.

But it always seems to go to the top of the post.

1 Like

Click the popup thing next to the markdown heading line. It pops to the top.click it again. The link is in the url bar now. If I use that like I just did for the zigbee thing, the title defaults to the page title but it pops into the right spot top of page.
https://community.home-assistant.io/t/the-home-assistant-cookbook-index/707144#zigbee-15

That’s what I did to get the example above. How come yours works and mine doesn’t? They look the same… :thinking: Browser?

Firefox here because I like torturing myself, don’t know if that’s it.

OK. your link went to the top. I clickec the icon, clicked it again, copied the url and it worked.

https://community.home-assistant.io/t/the-home-assistant-cookbook-index/707144#configuration-4

The easiest way would be to ask a team member, if the Discourse TOC (table of content) component could be activated. That would do the job automatically… :slight_smile:

See here:

@petro @tom_l
Can this component be activated? Have no idea, if it’s even possible, or if there are costs, just asking! :slight_smile:

EDIT:
@Stiltjack I added a TOC to the Cookbook index, hope this helps you. You’re doing so much writing for the Cookbook (thanks btw.), these copy&paste tasks are the least I can do. :slight_smile:
Please feel free to change or delete as you like! :slight_smile:

Btw. I found something, that could be the reason why it’s not working for you. When you tried, did you by any chance add a heading to your index, like “TOC”? If you did so, with saving the topic, all following anchors change the number at the end. You’d need to adjust them.

Original
https://community.home-assistant.io/t/the-home-assistant-cookbook-index/707144#getting-started-with-the-forum-1
By saving will get to:
https://community.home-assistant.io/t/the-home-assistant-cookbook-index/707144#toc-1
https://community.home-assistant.io/t/the-home-assistant-cookbook-index/707144#getting-started-with-the-forum-2

With the wrong number, it jumps back to the top of the post. :slight_smile:
And now ask, how I found out! :rofl: :rofl:

1 Like

You’re asking the wrong people. Moderators don’t have this ability. Try contacting a forum admin.

1 Like

That was it! Thank you. :grin:

Just wanted to get a summary on a single screen - as we know, people dislike scrolling down.

Is it worth keeping? In the light of your point, if a new category is added the whole TOC will have to be manually edited, not just the entry for that item. I suppose that doesn’t happen too often.

It’s also making the whole post a bit busy.

I was writing this for the cookbook but it has turned out more complicated than I like. What do you think?

https://community.home-assistant.io/t/how-to-use-context/723136

3 Likes

In the “experienced users” section, obviously, but a lot of people will love this. :grin:

2 Likes

Done! Sent a PM to balloob, frenck and Tinkerer. :slight_smile: Made myself unpopular by tagging all three of them, but I really don’t know, who is the right person to ask… :rofl: :rofl:

This is often the case with these lists. They grow, get better and more informative, but less readable. :slight_smile:

One solution to this would be to separate the chapters into single posts. We could link these from a TOC, and as we are able to edit all posts, we could set this up easily. Something along the lines

Post #1 (starting post) :: TOC
Post #2 :: Getting started with the forum
Post #3 :: Getting started with HA

You get the idea. :slight_smile: Advantage would be, that we could link form “outside” to a specific chapter. Besides the way better readability, we could also add some context to these posts without disrupting the whole single start post.

Regarding the numbers and the TOC: in a one-chapter-per-post system we wouldn’t need that. We would link to a normal post.
But, if we add new chapters, we’d have to change all following posts as well, as the order would change as well… Same, same I’d say! :wink:

Yes, add it! I read that with great interest and I’m sure it will be useful for really advanced users! :slight_smile:
:+1: from me! :slight_smile:

But people don’t follow links…

How about using one of those hidden menus for the TOC?

Summary

Personally, I can’t resist clicking on them.

@MissyQ right now, She owns inherited us as the Social Media Coordinator…

And if I were to guess, it will be added to the list and will be considered during the revamp coming sometime after Discord changes settle. The same time the layout for the Regulars category is enabled.

You all want change too soon, I’d rather it be carefully thought out and planned…
She knows what she’s doing.

1 Like

Would be nice, if this would be said anywhere… :wink: Are there any other things one should know? I haven’t heard about any of that. Regular category layout? What changes? :slight_smile:

Sorry, seems I’m not on the memo, but tell me more, it sounds really interesting. :wink:

There’s been some talk that I saw in the Discord server about it. :slight_smile:

1 Like

Ah, the Discord server, I always forget that one… :laughing:

1 Like

I have heard it suggested that we should watch the release party this week to know more.

Changes are coming is all I really know.

Lots of things are being considered. All I know are unsubstantiated rumors and leaks and I’m not passing any of that on, other than the Discourse changes are sometime after the Discord changes have settled a bit.
I have confidence it is in good hands and that at this point suggestions are welcome and will be added to the consideration list. (But she pretty much promised the level3 (regulars) only thread, so that’s kinda a given.)

2 Likes

I hate changes. :face_with_symbols_over_mouth:

1 Like

omg stop being such a curmudgeon! (I’ve been waiting all day to use that word!) lol

Actually, I hate changes too, but from what I’ve heard (the same pretty much as @Sir_Goodenough), they could be good. I have high hopes at least as Missy seems to be on top of things and that’s been sorely missing for a long time.

3 Likes

I am starting to be a fan of changes.
They give me something to bitch about.

3 Likes

But back to business…

Any thoughts on “Zigbee devices that don’t play nice”?