Add support for templates in wikis
What does this MR do and why?
Add support for templates in wikis
- Templates are wiki pages too, but in UI we call them "templates" instead of "pages".
- Templates are stored in
/wiki/templates/directory. - To access all templates or to create a new template or edit an existing template, click the new "Templates" link in the sidebar.
- You can do all actions that were previously possible on wiki pages on templates as well. This includes template version history, author details and diff comparison with previous version.
- We support templates in all formats: Markdown, RDoc, AsciiDoc and Org.
- Attachments are disabled for templates.
- This feature works in both project and group wikis. Group wikis are EE only.
- You can create/edit templates in both plain and rich text editors.
- Template dropdown filters templates by the format type you choose. Eg. Markdown templates can only be applied on Markdown pages.
Out of scope of this MR:
- Inheriting templates: A project should be able to inherit and use templates from its own wiki and also any parent group wikis.
- File attachments in templates: If you upload a file/image in a template, and then later use that template, the file/image will be broken, so I disabled this feature. To support it properly, we need to map paths of the file/image to the path of the current wiki page.
MR acceptance checklist
Please evaluate this MR against the MR acceptance checklist. It helps you analyze changes to reduce risks in quality, performance, reliability, security, and maintainability.
Screenshots or screen recordings
How to set up and validate locally
- In the wiki sidebar (right), click the new "Templates" link
- Click "+ New Template"
- Fill in the details and save.
- Go back to wiki home page.
- Create a new page by clicking "New Page".
- In the template dropdown above content, select the template you just created.
- Template should apply to the wiki page.
Related issues/epics
Edited by Himanshu Kapoor