comparison doc/customizing.txt @ 6448:2bd60def4fed

Improve doc on special action vars in cusotmizing.txt. Added example html inputs to illustrate the doc. Fix position of designator in doc example. It occurs before @link@ or other edit command.
author John Rouillard <rouilj@ieee.org>
date Sat, 26 Jun 2021 22:58:56 -0400
parents 2917231d8076
children 258385cad27e
comparison
equal deleted inserted replaced
6447:8f8f4988b856 6448:2bd60def4fed
2443 This is equivalent to:: 2443 This is equivalent to::
2444 2444
2445 @link@messages=msg-1 2445 @link@messages=msg-1
2446 msg-1@content=value 2446 msg-1@content=value
2447 2447
2448 which is equivalent to the html::
2449
2450 <textarea name="msg-1@content"></textarea>
2451 <input type="hidden" name="@link@messages" value="msg-1">
2452
2448 except that in addition, the "author" and "date" properties of 2453 except that in addition, the "author" and "date" properties of
2449 "msg-1" are set to the userid of the submitter, and the current 2454 "msg-1" are set to the userid of the submitter, and the current
2450 time, respectively. 2455 time, respectively.
2451 2456
2452 @file 2457 @file
2453 This is equivalent to:: 2458 This is equivalent to::
2454 2459
2455 @link@files=file-1 2460 @link@files=file-1
2456 file-1@content=value 2461 file-1@content=value
2457 2462
2463 by adding the HTML::
2464
2465 <input type="file" name="file-1@content">
2466 <input type="hidden" name="@link@files" value="file-1">
2467
2458 The String content value is handled as described above for file 2468 The String content value is handled as described above for file
2459 uploads. 2469 uploads.
2460 2470
2461 If both the "@note" and "@file" form variables are 2471 If both the "@note" and "@file" form variables are
2462 specified, the action:: 2472 specified, the action::
2463 2473
2464 @link@msg-1@files=file-1 2474 msg-1@link@files=file-1
2465 2475
2466 is also performed. 2476 is also performed. This would be expressed in HTML with::
2477
2478 <input type="hidden" name="msg-1@link@files" value="file-1">
2467 2479
2468 We also check that FileClass items have a "content" property with 2480 We also check that FileClass items have a "content" property with
2469 actual content, otherwise we remove them from all_props before 2481 actual content, otherwise we remove them from all_props before
2470 returning. 2482 returning.
2471 2483

Roundup Issue Tracker: http://roundup-tracker.org/