Templates / Content Transclusion / Infoboxes
in progress
T
Tribly
Have a template or transclusion function, just like in MediaWiki(https://www.mediawiki.org/wiki/Help:Templates), which would give people the ability to create infoboxes or other types of templates that are used on many other wikis.
T
TheMet4lGod
One issue with using Mediawiki's Templates is that the parts are imported from the template page so any changes made to it apply to all documents it's used in. The actual plugin/feature you might be wanting is called Boilerplate which is the same thing as making a new page and creating from a Template in Wiki.js.
martin f. krafft
TheMet4lGod How is this an issue? I consider it a feature to keep the data and presentation separate, precisely so that you can change presentation in one place only, rather than having to touch all copies made in the past.
T
TheMet4lGod
martin f. krafft For one, the documentation for it is not the best quality. Also, when I am one guy setting up a wiki site for everyone else to use (in a intranet work setting) having to spend time tinkering on a plugin for it to work as I expect it to (and to other's needs) is arguably wasted time.
martin f. krafft
TheMet4lGod I don't want the plugin. I would like to be able to define a custom template for a certain set of wiki pages. See https://github.com/requarks/wiki/discussions/7465
Nicolas Giard
Merged in a post:
Modular documentation
Zuzana Hennelova
Hello, I would like to suggest to make it possible for teams to develop modular procedures and documents. Meaning: Create small modules. Out of those modules create one big document with possibility to add more text. When the module is updated, all documents with that module will be updated as well.
Erik van Berkum
already possible by using asciidoc pages, i believe there must also be syntax for markdown.
in asciidoc you simply do:
== disclaimer
include::/general/disclaimer_adoc.adoc[]
== meaning of symbols
include::/general/meaning_of_symbols_adoc.adoc[]
Tim Elmer
Erik van Berkum How are you testing this? I tried including another AsciiDoc page, and an uploaded asset, neither work. Additionally, there is no provision in vanilla Markdown to include files, and none is called out in Wiki.js' documentation.
Erik van Berkum
Tim Elmer
Our workflow is as follows we are a manufacturing company and make product manuals, built instructions and CE documentation in wikijs. As for products manuals they all share the same warranty, disclaimer, meaning of symbols etc.
So we simply create the specific product asciidoc document and import the warranty file which is just another asciidoc page with the code:
include::/general/warranty.adoc
wikiJS than renders this file perfectly when not in editing mode.
In our case, it commits to the github repository. After that we pull the document from the github repository to a windows machine and have a script to create a pdf with asciidoctor pdf. Especially for our CE documentation which are over a 1000 pages this works flawlessly when their is any update.
A few years ago we started this in markdown, but functionality was too limited so we switched to asciidoctor. Now i remember correctly markdown was indeed not redering the include files.
Stinkys
Hi Nicolas Giard and dev team o/
Just thought I would check back in on this. It's been logged since 2018 and in progress since 2021. Where does it currently sit on the roadmap and priority?
Without banging on about our particular use case, this functionality is highly desirable for our org. You lot have made a great product and I am hoping to roll it out to my users soon.
Matt Harms
Transclusion is a common feature of wikis and if awiki.js wants to stay competitive, this feature should absolutely be included.
Nicolas Giard
Merged in a post:
Embed page or paragraph contents
Stinkys
It would be great if content from a page can be dynamically embedded into another page - something Bookstack can do.
Use case: You have controlled documents that change infrequently, such as policies and procedures. A user in a department creates an uncontrolled document and wants to reference, by embedding, the controlled document or a portion of it. If the controlled doc is updated later at some point in the future, this will update immediately in the uncontrolled document contents.
To clarify, this is not a reference link that opens up another page. This is a block of content from page A that is inserted into page B, and when page A is updated, that content block in page B is updated in real-time also. Benefits include ensuring that everyone has the same source of truth and cuts down on page maintenance caused by edits up-stream.
(Apologies if this has been raised before or already exists, I'm new here. I had a fair search for this feature.)
Nicolas Giard
Merged in a post:
page embedding
Maarten Berkenbosch
I want to document some software code and would like to write one page that defines an object with properties. Then in multiple other pages, I want to reference this object page by embedding it in other pages.
This way I only have to change the object page in order to keep all other pages up to date.
Nicolas Giard
Merged in a post:
Include Markdown Files
Witold Szal
When markdown files need to be repeated in multiple articles, INCLUDE block can be used.
Here is better description: https://dotnet.github.io/docfx/docs/markdown.html?tabs=linux%2Cdotnet#include-markdown-files
Vincent Gerris
plus 1
Albert Akchurin
Agree, it will be great
Load More
→