@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Improve Remarkup embed documentation
Summary: Group all the embed documentation together and mention the new Paste features.
Test Plan: {F35993}
Reviewers: ljalonen
Reviewed By: ljalonen
CC: aran
Differential Revision: https://secure.phabricator.com/D5348
+47
-25
+47
-25
src/docs/userguide/remarkup.diviner
+47
-25
src/docs/userguide/remarkup.diviner
···
261
261
262
262
T123#4 # Link to comment #4 of T123
263
263
264
+
= Embedding Objects
265
+
264
266
You can also generate full-name references to some objects by using braces:
265
267
266
268
{D123} # Link to Differential revision D123 with the full name
267
269
{T123} # Link to Maniphest task T123 with the full name
268
270
269
271
These references will also show when an object changes state (for instance, a
270
-
task or revision is closed).
272
+
task or revision is closed). Some types of objects support rich embedding.
271
273
272
-
= Quoting Text =
274
+
== Embedding Mocks (Pholio)
273
275
274
-
To quote text, preface it with an ">":
276
+
You can embed a Pholio mock by using braces to refer to it:
275
277
276
-
> This is quoted text.
278
+
{M123}
277
279
278
-
This appears like this:
280
+
By default the first four images from the mock set are displayed. This behavior
281
+
can be overridden with the **image** option. With the **image** option you can
282
+
provide one or more image IDs to display.
279
283
280
-
> This is quoted text.
284
+
You can set the image (or images) to display like this:
281
285
282
-
= Embedding Images =
286
+
{M123, image=12345}
287
+
{M123, image=12345 & 6789}
283
288
284
-
You can embed an image by using braces to refer to it:
289
+
== Embedding Pastes
285
290
286
-
{F123} # Embed the image file F123
291
+
You can embed a Paste using braces:
292
+
293
+
{P123}
294
+
295
+
You can adjust the embed height with the `lines` option:
296
+
297
+
{P123, lines=15}
298
+
299
+
You can highlight specific lines with the `highlight` option:
300
+
301
+
{P123, highlight=15}
302
+
{P123, highlight="23-25, 31"}
303
+
304
+
== Embedding Images
305
+
306
+
You can embed an image or other file by using braces to refer to it:
307
+
308
+
{F123}
287
309
288
310
In most interfaces, you can drag-and-drop an image from your computer into the
289
311
text area to upload and reference it.
···
304
326
- **size** thumb (default), full
305
327
- **name** with `layout=link` or for non-images, use this name for the link
306
328
text
329
+
330
+
== Embedding Countdowns
331
+
332
+
You can embed a countdown by using braces:
333
+
334
+
{C123}
335
+
336
+
= Quoting Text =
337
+
338
+
To quote text, preface it with an ">":
339
+
340
+
> This is quoted text.
341
+
342
+
This appears like this:
343
+
344
+
> This is quoted text.
307
345
308
346
= Embedding Media =
309
347
···
424
462
not);
425
463
- you can use other Remarkup rules (like **bold**, //italics//, etc.) inside
426
464
table cells.
427
-
428
-
= Embedding Pholio mocks =
429
-
430
-
You can embed a Pholio mock by using braces to refer to it:
431
-
432
-
{M123} # Embed the mock M123
433
-
434
-
By default the first four images from the mock set are displayed. This behavior
435
-
can be overridden with the **image** option. With the **image** option you can
436
-
provide one or more imageIDs to display.
437
-
438
-
You can set the image (or images) to display like this:
439
-
440
-
{M123, image=12345}
441
-
442
-
{M123, image=12345 & 6789}