← Back to team overview

maria-docs team mailing list archive

KB Macro Proposal

 

All,

Based on an IRC discussion from yesterday, I whipped up a prototype of
a couple of macros for use in code examples.

The macros would be <<input>> and <<output>> and would be used almost
the same way as the <<code>> macro (the main difference being that
they cannot be used "inline"). For example:

<<input lang=sql>>
SELECT * FROM t1 WHERE d LIKE "%es%";
<</input>>

<<output>>
+-----------+
| d         |
+-----------+
| Tuesday   |
| Wednesday |
+-----------+
<</output>>

I've created a couple of prototypes (screenshots attached) of how it
could look (hopefully the list will allow the attachements). I like v1
better, but I'm not enough of a css guru to know how to get the
overflow to work right (I like v2 as well). 

The idea is to be able to easily indicate input and expected output for
SQL (and other) examples and have it be consistent across pages in the
KB.

Thoughts?

-- 
Daniel Bartholomew
MariaDB - http://mariadb.org
Monty Program - http://montyprogram.com
AskMonty Knowledgebase - http://kb.askmonty.org

Attachment: LIKE-v1.png
Description: PNG image

Attachment: LIKE-v2.png
Description: PNG image


Follow ups