mirror of
https://github.com/BookStackApp/BookStack.git
synced 2026-07-16 05:33:49 +03:00
Support links in Shelf/Book descriptions #1926
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Originally created by @qwertyuu on GitHub (Nov 5, 2020).
Describe the feature you'd like
Right now the "Description" part of a shelf or a book is only plaintext. I would like, at least, for it to support links... if not markdown
Describe the benefits this feature would bring to BookStack users
We use Bookshelf to document a project and having "post-it" links would be beneficial to everyone in my opinion
Additional context
Here is an example of a link in a description
@bennyandresen commented on GitHub (Jul 29, 2023):
I hope I'm not breaking etiquette but I looked for an already existing issue about markdown in the description and I can only confirm that I'm also looking forward to that feature for the exact same reason.
@axelsimon commented on GitHub (Sep 5, 2023):
I'm also surprised that while book pages can contain markdown, the "cover" of a book cannot, so you just end up with unclickable links.
Any plans to fix this?
@ssddanbrown commented on GitHub (Sep 6, 2023):
It's not really something I see to "fix" since it's not really a bug IMO.
Probably won't support markdown in these boxes, as that doesn't really work to the target audience/UX I aim for, and I don't want to support multiple implementations for different audiences like with the page editor.
As per the "Next Steps" of our latest release post, I may look to align a few areas with a simplified WYSIWYG editor, which could include description boxes to bring simple formatting.
@bennyandresen commented on GitHub (Sep 6, 2023):
If a simplified WYSIWYG editor is introduced that converts a subset of formatting to html including
aand can, as the current description can, be set via the API, then my use case would be satisfied.@nikkilocke commented on GitHub (Sep 7, 2023):
I can't understand what the objection is to allowing markdown. It appears to be easy to implement, it wouldn't affect users who don't need it (they are unlikely to use markdown here by accident), and it allows cross-referencing between books (for example).
If voting counts, I vote for the change.
@ssddanbrown commented on GitHub (Sep 7, 2023):
@nikkilocke One of my core focuses for BookStack has been to create a platform suitable for mixed-skill environments, to the general idea of it being comfortable to anyone that is comfortable using a word processor.
I'm not keen on adding abilities to core content functionality that may be less accessible & intuitive to that target audience, especially as this could be used in that mixed-skill environment leaving less-technical users to come across markdown provided by other more technical users.
Ease of implementation is rarely a reason for me to consider something to be honest.
It's easy to add things, but they all have a cost so I'm relatively strict on anything added to the platform, however small.
Purpose, functional benefit, existing-audience desire, fit with other platform features/functions, and platform suitability relative to our intended audience are usually larger factors I consider.
I do consider the 👍 reactions on the original post in the thread. Not really needed here though since, as per my last comment, I am intent in working towards this.
@ssddanbrown commented on GitHub (Dec 22, 2023):
A WYSWIYG for description inputs, with the ability to use links upon some other simple formatting options, has now been added via PR #4729 and will be part of the next feature release. Therefore I'll close this off.
Thanks @qwertyuu for the original request here.