]> BookStack Code Mirror - website/commitdiff
Fixed forcing-content ID instructions to be correct
authorDan Brown <redacted>
Sat, 15 Feb 2020 21:57:54 +0000 (21:57 +0000)
committerDan Brown <redacted>
Sat, 15 Feb 2020 21:59:21 +0000 (21:59 +0000)
- Did not mentoin needing to use the bkmrk prefix before.

For BookStackApp/BookStack#1894

content/docs/user/reusing-content.md

index 014ed97d3d0b355f0d30d368ed88151412dccf12..963ffae34d9e30e8e13352b880c98f284c2b28b4 100644 (file)
@@ -33,9 +33,9 @@ By default this contains a direct link to that content. If you click the link ic
 
 ## Forcing Content IDs
 
-When including a specific block of content the id of the block is used (part after the hash). By default these are generated by BookStack when you save a page. If you are using the WYSIWYG editor the id will stay the same unless the block is removed or re-formatted. In the markdown editor it changes with every save and references the content so while it may remain the same there's a good chance an ID can change.
+When including a specific block of content the id of the block is used (part after the hash). By default these are generated by BookStack when you save a page. If you are using the WYSIWYG editor the id will stay the same unless the block is removed or re-formatted. In the markdown editor it changes with every save based on the content so while it may remain the same there's a good chance an ID can change therefore it's recommended to force an ID if you're using the content for includes.
 
-Due to the fact IDs can change it's recommended to force IDs on your content:
+**Note: All ID values must start with "bkmrk" to avoid being overwritten.**
 
 #### WYSIWYG Editor
 
@@ -49,9 +49,8 @@ In the markdown editor you can simply insert HTML with an ID to ensure it does n
 
 ```
 # Old Content
-Copyright BookStack Enterprises 2017
+Copyright BookStack Enterprises 2020
 
 # Revised with ID
-<p id="include-copyright-text">Copyright BookStack Enterprises 2017</p>
-
+<p id="bkmrk-include-copyright-text">Copyright BookStack Enterprises 2020</p>
 ```