mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-09 16:32:39 +01:00
Document remarkup and bring over the <tt> rule from Diviner.
This commit is contained in:
parent
4ca2072773
commit
43775a11e0
4 changed files with 171 additions and 40 deletions
|
@ -348,6 +348,9 @@ return array(
|
|||
|
||||
// -- Remarkup -------------------------------------------------------------- //
|
||||
|
||||
// If you enable this, linked YouTube videos will be embeded inline. This has
|
||||
// mild security implications (you'll leak referrers to YouTube) and is pretty
|
||||
// silly (but sort of awesome).
|
||||
'remarkup.enable-embedded-youtube' => false,
|
||||
|
||||
// -- Customization --------------------------------------------------------- //
|
||||
|
|
|
@ -931,7 +931,7 @@ celerity_register_resource_map(array(
|
|||
),
|
||||
'phabricator-remarkup-css' =>
|
||||
array(
|
||||
'uri' => '/res/fc827787/rsrc/css/core/remarkup.css',
|
||||
'uri' => '/res/774d4078/rsrc/css/core/remarkup.css',
|
||||
'type' => 'css',
|
||||
'requires' =>
|
||||
array(
|
||||
|
@ -1002,30 +1002,6 @@ celerity_register_resource_map(array(
|
|||
'uri' => '/res/pkg/122a6b6d/workflow.pkg.js',
|
||||
'type' => 'js',
|
||||
),
|
||||
'196b23d4' =>
|
||||
array (
|
||||
'name' => 'core.pkg.css',
|
||||
'symbols' =>
|
||||
array (
|
||||
0 => 'phabricator-core-css',
|
||||
1 => 'phabricator-core-buttons-css',
|
||||
2 => 'phabricator-standard-page-view',
|
||||
3 => 'aphront-dialog-view-css',
|
||||
4 => 'aphront-form-view-css',
|
||||
5 => 'aphront-panel-view-css',
|
||||
6 => 'aphront-side-nav-view-css',
|
||||
7 => 'aphront-table-view-css',
|
||||
8 => 'aphront-crumbs-view-css',
|
||||
9 => 'aphront-tokenizer-control-css',
|
||||
10 => 'aphront-typeahead-control-css',
|
||||
11 => 'aphront-list-filter-view-css',
|
||||
12 => 'phabricator-directory-css',
|
||||
13 => 'phabricator-remarkup-css',
|
||||
14 => 'syntax-highlighting-css',
|
||||
),
|
||||
'uri' => '/res/pkg/196b23d4/core.pkg.css',
|
||||
'type' => 'css',
|
||||
),
|
||||
'1ac25e8a' =>
|
||||
array (
|
||||
'name' => 'differential.pkg.css',
|
||||
|
@ -1059,6 +1035,30 @@ celerity_register_resource_map(array(
|
|||
'uri' => '/res/pkg/33f413ef/typeahead.pkg.js',
|
||||
'type' => 'js',
|
||||
),
|
||||
'7fce98ed' =>
|
||||
array (
|
||||
'name' => 'core.pkg.css',
|
||||
'symbols' =>
|
||||
array (
|
||||
0 => 'phabricator-core-css',
|
||||
1 => 'phabricator-core-buttons-css',
|
||||
2 => 'phabricator-standard-page-view',
|
||||
3 => 'aphront-dialog-view-css',
|
||||
4 => 'aphront-form-view-css',
|
||||
5 => 'aphront-panel-view-css',
|
||||
6 => 'aphront-side-nav-view-css',
|
||||
7 => 'aphront-table-view-css',
|
||||
8 => 'aphront-crumbs-view-css',
|
||||
9 => 'aphront-tokenizer-control-css',
|
||||
10 => 'aphront-typeahead-control-css',
|
||||
11 => 'aphront-list-filter-view-css',
|
||||
12 => 'phabricator-directory-css',
|
||||
13 => 'phabricator-remarkup-css',
|
||||
14 => 'syntax-highlighting-css',
|
||||
),
|
||||
'uri' => '/res/pkg/7fce98ed/core.pkg.css',
|
||||
'type' => 'css',
|
||||
),
|
||||
'd985d27a' =>
|
||||
array (
|
||||
'name' => 'javelin.pkg.js',
|
||||
|
@ -1095,15 +1095,15 @@ celerity_register_resource_map(array(
|
|||
),
|
||||
'reverse' =>
|
||||
array (
|
||||
'aphront-crumbs-view-css' => '196b23d4',
|
||||
'aphront-dialog-view-css' => '196b23d4',
|
||||
'aphront-form-view-css' => '196b23d4',
|
||||
'aphront-list-filter-view-css' => '196b23d4',
|
||||
'aphront-panel-view-css' => '196b23d4',
|
||||
'aphront-side-nav-view-css' => '196b23d4',
|
||||
'aphront-table-view-css' => '196b23d4',
|
||||
'aphront-tokenizer-control-css' => '196b23d4',
|
||||
'aphront-typeahead-control-css' => '196b23d4',
|
||||
'aphront-crumbs-view-css' => '7fce98ed',
|
||||
'aphront-dialog-view-css' => '7fce98ed',
|
||||
'aphront-form-view-css' => '7fce98ed',
|
||||
'aphront-list-filter-view-css' => '7fce98ed',
|
||||
'aphront-panel-view-css' => '7fce98ed',
|
||||
'aphront-side-nav-view-css' => '7fce98ed',
|
||||
'aphront-table-view-css' => '7fce98ed',
|
||||
'aphront-tokenizer-control-css' => '7fce98ed',
|
||||
'aphront-typeahead-control-css' => '7fce98ed',
|
||||
'differential-changeset-view-css' => '1ac25e8a',
|
||||
'differential-core-view-css' => '1ac25e8a',
|
||||
'differential-revision-add-comment-css' => '1ac25e8a',
|
||||
|
@ -1138,11 +1138,11 @@ celerity_register_resource_map(array(
|
|||
'javelin-util' => 'd985d27a',
|
||||
'javelin-vector' => 'd985d27a',
|
||||
'javelin-workflow' => '122a6b6d',
|
||||
'phabricator-core-buttons-css' => '196b23d4',
|
||||
'phabricator-core-css' => '196b23d4',
|
||||
'phabricator-directory-css' => '196b23d4',
|
||||
'phabricator-remarkup-css' => '196b23d4',
|
||||
'phabricator-standard-page-view' => '196b23d4',
|
||||
'syntax-highlighting-css' => '196b23d4',
|
||||
'phabricator-core-buttons-css' => '7fce98ed',
|
||||
'phabricator-core-css' => '7fce98ed',
|
||||
'phabricator-directory-css' => '7fce98ed',
|
||||
'phabricator-remarkup-css' => '7fce98ed',
|
||||
'phabricator-standard-page-view' => '7fce98ed',
|
||||
'syntax-highlighting-css' => '7fce98ed',
|
||||
),
|
||||
));
|
||||
|
|
122
src/docs/userguide/remarkup.diviner
Normal file
122
src/docs/userguide/remarkup.diviner
Normal file
|
@ -0,0 +1,122 @@
|
|||
@title Remarkup Reference
|
||||
@group userguide
|
||||
|
||||
Explains how to make bold text, etc.
|
||||
|
||||
= Overview =
|
||||
|
||||
Phabricator uses a lightweight markup language called "Remarkup", similar to
|
||||
other lightweight markup langauges like Markdown and Wiki markup.
|
||||
|
||||
This document describes how to format text using Remarkup.
|
||||
|
||||
= Basic Styling =
|
||||
|
||||
Format **basic text styles** like this:
|
||||
|
||||
**bold text**
|
||||
//italic text//
|
||||
##monospaced text##
|
||||
|
||||
Those produce **bold text**, //italic text// and ##monospaced text##,
|
||||
respectively.
|
||||
|
||||
= Layout =
|
||||
|
||||
Make **headers** like this:
|
||||
|
||||
= Large Header =
|
||||
== Smaller Header ==
|
||||
===== Very Small Header =====
|
||||
|
||||
This produces headers like the ones in this document.
|
||||
|
||||
Make **lists** by indenting two spaces and beginning each item with a "-":
|
||||
|
||||
lang=demo
|
||||
- milk
|
||||
- eggs
|
||||
- bread
|
||||
|
||||
This produces a list like this:
|
||||
|
||||
- milk
|
||||
- eggs
|
||||
- bread
|
||||
|
||||
Make **code blocks** by indenting two spaces:
|
||||
|
||||
f(x, y);
|
||||
|
||||
You can specify a language for syntax highlighting with "lang=xxx":
|
||||
|
||||
lang=demo
|
||||
lang=html
|
||||
<a href="#">...</a>
|
||||
|
||||
This will highlight the block using a highlighter for that language, if one is
|
||||
available (in most cases, this means you need to configure Pygments):
|
||||
|
||||
lang=html
|
||||
<a href="#">...</a>
|
||||
|
||||
You can also use a "COUNTEREXAMPLE" header to show that a block of code is
|
||||
bad and shouldn't be copied:
|
||||
|
||||
lang=demo
|
||||
COUNTEREXAMPLE
|
||||
function f() {
|
||||
global $$variable_variable;
|
||||
}
|
||||
|
||||
This produces a block like this:
|
||||
|
||||
COUNTEREXAMPLE
|
||||
function f() {
|
||||
global $$variable_variable;
|
||||
}
|
||||
|
||||
= Linking URIs =
|
||||
|
||||
URIs are automatically linked: http://phabricator.org/
|
||||
|
||||
If you have a URI with problematic characters in it, like
|
||||
"##http://comma.org/,##", you can surround it with angle brackets:
|
||||
|
||||
<http://comma.org/,>
|
||||
|
||||
This will force the parser to consume the whole URI: <http://comma.org/,>
|
||||
|
||||
= Linking to Objects =
|
||||
|
||||
You can link to Differential revisions, Diffusion commits and Maniphest tasks
|
||||
by mentioning the name of an object:
|
||||
|
||||
D123 # Link to Differential revision D123
|
||||
rX123 # Link to SVN commit 123 from the "X" repository
|
||||
rXaf3192cd5 # Link to Git commit "af3192cd5..." from the "X" repository.
|
||||
# You must specify at least 7 characters of the hash.
|
||||
T123 # Link to Maniphest task T123
|
||||
|
||||
= Quoting Text =
|
||||
|
||||
To quote text, preface it with an ">":
|
||||
|
||||
> This is quoted text.
|
||||
|
||||
This appears like this:
|
||||
|
||||
> This is quoted text.
|
||||
|
||||
= Embedding Media =
|
||||
|
||||
If you set configuration flags, you can embed media directly in text:
|
||||
|
||||
- **files.enable-proxy**: allows you to paste in image URLs and have them
|
||||
render inline.
|
||||
- **remarkup.enable-embedded-youtube**: allows you to paste in YouTube videos
|
||||
and have them render inline.
|
||||
|
||||
These options are disabled by default because they have security and/or
|
||||
silliness implications, read their descriptions in ##default.conf.php## before
|
||||
enabling them.
|
|
@ -31,6 +31,12 @@
|
|||
background-color: #ffaaaa;
|
||||
}
|
||||
|
||||
.phabricator-remarkup tt {
|
||||
color: #333333;
|
||||
background: #ebebeb;
|
||||
padding: 0 .25em;
|
||||
}
|
||||
|
||||
.phabricator-remarkup ul {
|
||||
list-style: disc;
|
||||
margin: 1em 0 1em 3em;
|
||||
|
|
Loading…
Reference in a new issue