mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-22 14:52:41 +01:00
Add documentation for cowsay
Summary: Cowsay is great, but what if you want to talk like a koala? This diff adds diviner documentation on how to use the additional templates in externals/cowsay/cows/ Test Plan: bin/diviner generate https://my.phorge.site/book/phorge/article/differential_cowsay/ Reviewers: O1 Blessed Committers, valerio.bozzolan Reviewed By: O1 Blessed Committers, valerio.bozzolan Subscribers: tobiaswiese, valerio.bozzolan, Matthew, Cigaryno Differential Revision: https://we.phorge.it/D25434
This commit is contained in:
parent
a0fb344b94
commit
91faf16cac
4 changed files with 73 additions and 2 deletions
|
@ -66,6 +66,7 @@ Continue by:
|
||||||
- diving into the details of inline comments in
|
- diving into the details of inline comments in
|
||||||
@{article:Differential User Guide: Inline Comments}; or
|
@{article:Differential User Guide: Inline Comments}; or
|
||||||
- reading the FAQ at @{article:Differential User Guide: FAQ}; or
|
- reading the FAQ at @{article:Differential User Guide: FAQ}; or
|
||||||
|
- learning how to use markup in comments at @{article:Remarkup Reference}; or
|
||||||
- learning about test plans in
|
- learning about test plans in
|
||||||
@{article:Differential User Guide: Test Plans}; or
|
@{article:Differential User Guide: Test Plans}; or
|
||||||
- learning more about Herald in @{article:Herald User Guide}.
|
- learning more about Herald in @{article:Herald User Guide}.
|
||||||
|
|
|
@ -41,8 +41,9 @@ always "request review" of an accepted revision, with a comment like:
|
||||||
|
|
||||||
If authors are being jerks about this (making sweeping changes as soon as they
|
If authors are being jerks about this (making sweeping changes as soon as they
|
||||||
get an accept), solve the problem socially by telling them to stop being jerks.
|
get an accept), solve the problem socially by telling them to stop being jerks.
|
||||||
Unless you've configured additional layers of enforcement, there's nothing
|
Unless you've configured additional layers of enforcement (by
|
||||||
stopping them from silently changing the code before pushing it, anyway.
|
using @{article:Herald}), there's nothing stopping them from silently changing
|
||||||
|
the code before pushing it, anyway.
|
||||||
|
|
||||||
|
|
||||||
= How can I enable syntax highlighting? =
|
= How can I enable syntax highlighting? =
|
||||||
|
@ -50,6 +51,10 @@ stopping them from silently changing the code before pushing it, anyway.
|
||||||
You need to install and configure **Pygments** to highlight anything else than
|
You need to install and configure **Pygments** to highlight anything else than
|
||||||
PHP. See the `pygments.enabled` configuration setting.
|
PHP. See the `pygments.enabled` configuration setting.
|
||||||
|
|
||||||
|
= What formatting can be used in comments? =
|
||||||
|
|
||||||
|
Phorge implements a markup language similar to other markup languages like
|
||||||
|
Markdown and Wiki markup. See @{article:Remarkup Reference}.
|
||||||
|
|
||||||
= What do the very light green and red backgrounds mean? =
|
= What do the very light green and red backgrounds mean? =
|
||||||
|
|
||||||
|
|
|
@ -732,3 +732,7 @@ to the first anchor with "xyz" as a prefix of the anchor name.
|
||||||
Remarkup editors provide a fullscreen composition mode. This can make it easier
|
Remarkup editors provide a fullscreen composition mode. This can make it easier
|
||||||
to edit large blocks of text, or improve focus by removing distractions. You can
|
to edit large blocks of text, or improve focus by removing distractions. You can
|
||||||
exit **Fullscreen** mode by clicking the button again or by pressing escape.
|
exit **Fullscreen** mode by clicking the button again or by pressing escape.
|
||||||
|
|
||||||
|
See Also
|
||||||
|
========
|
||||||
|
* @{article:Remarkup Reference: Cowsay}
|
||||||
|
|
61
src/docs/user/userguide/remarkup_cowsay.diviner
Normal file
61
src/docs/user/userguide/remarkup_cowsay.diviner
Normal file
|
@ -0,0 +1,61 @@
|
||||||
|
@title Remarkup Reference: Cowsay
|
||||||
|
@group userguide
|
||||||
|
|
||||||
|
Overview
|
||||||
|
--------
|
||||||
|
|
||||||
|
Cowsay is an application by Tony Monroe which has been ported over to
|
||||||
|
Phabricator/Phorge to allow your comments to be voiced by
|
||||||
|
a cow.
|
||||||
|
|
||||||
|
Basic Usage
|
||||||
|
-----------
|
||||||
|
|
||||||
|
A basic example of using cowsay would be to add a comment
|
||||||
|
cowsay{{{Great work!}}}
|
||||||
|
which generates:
|
||||||
|
```
|
||||||
|
_____________
|
||||||
|
< Great work! >
|
||||||
|
-------------
|
||||||
|
\ ^__^
|
||||||
|
\ (oo)\_______
|
||||||
|
(__)\ )\/\
|
||||||
|
||----w |
|
||||||
|
|| ||
|
||||||
|
```
|
||||||
|
|
||||||
|
Other Cowsay Templates
|
||||||
|
----------------------
|
||||||
|
Other templates are available in externals/cowsay/cows/, and you can specify
|
||||||
|
one by calling cowsay with the 'cow' parameter. eg:
|
||||||
|
cowsay(cow='tux'){{{Great work!}}}
|
||||||
|
generates
|
||||||
|
```
|
||||||
|
_____________
|
||||||
|
< Great work! >
|
||||||
|
-------------
|
||||||
|
\
|
||||||
|
\
|
||||||
|
.--.
|
||||||
|
|o_o |
|
||||||
|
|:_/ |
|
||||||
|
// \ \
|
||||||
|
(| | )
|
||||||
|
/'\_ _/`\
|
||||||
|
\___)=(___/
|
||||||
|
```
|
||||||
|
|
||||||
|
Other Parameters
|
||||||
|
----------------
|
||||||
|
* think (set to 1 for thinking bubbles)
|
||||||
|
* eyes (default 'oo')
|
||||||
|
* tongue (default ' ', try 'P')
|
||||||
|
|
||||||
|
See Also
|
||||||
|
========
|
||||||
|
* @{article:Remarkup Reference}
|
||||||
|
* Have you tried figlet:
|
||||||
|
```
|
||||||
|
figlet{{{figlet generates big text!}}}
|
||||||
|
```
|
Loading…
Reference in a new issue