[Koha-bugs] [Bug 29712] [DOCS] [Omnibus] Content development guide

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29712

--- Comment #8 from Caroline Cyr La Rose <caroline.cyr-la-rose at inlibro.com> ---
Aude told me she liked the option to differentiate the "new in version" (koha
green box) and "removed in version" (warning orange box).

This is a bit more complicated for the documenter, but I found a way to change
the colour of the box for "new in version" and "removed in version", while
keeping it a "Version note". https://snipboard.io/8nKLcM.jpg


We first have to declare the "roles" at the top of each page

.. role:: new-in-version
.. role:: removed-in-version

Then, before writing the note, we have to place it in a "container" and indent
it

.. container:: new-in-version

   .. Admonition:: Version note

      New in version note.

.. container:: removed-in-version

   .. Admonition:: Version note

      Removed in version note.


And add some custom css (this is done only once, so it's ok, we just have to
choose the colours)

.rst-content .new-in-version .admonition-version-note .admonition-title {
 background: #b342f5;
}

.rst-content .new-in-version .admonition-version-note {
  background: #e2bef7;
  }

.rst-content .removed-in-version .admonition-version-note .admonition-title {
 background: #fa46f1;
}

.rst-content .removed-in-version .admonition-version-note {
  background: #f7bef4;
  }


I think this is a bit too elaborate for us, but I would like to keep the
"Warning" to actual warnings... Anyway, we'll be able to discuss this further
at the meeting... 

Let me know if you have other ideas, I can prepare them for the meeting to have
examples to look at.

-- 
You are receiving this mail because:
You are watching all bug changes.