Description
Encode a supplied document, section and one-based paragraph locator.
Critical annotations distinguish source voices, editorial insertions, omission markers, edition locators and caller-assigned interpretations. Case preservation and half-open text offsets describe representation rather than meaning. A bracketed token or source-role label does not verify faithful quotation, authority, an argument or its historical context.
Encode a supplied document, section and one-based paragraph locator.
When to use this tool
Use Public Text Position Code when you already have documentId, sectionCode, paragraph and need to encode a supplied document, section and one-based paragraph locator.
How to use the tool and how it works
- Enter documentId, sectionCode, paragraph. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read token. Use the output convention below.
Require documentId/sectionCode nonempty and paragraph a positive safe integer; serialize [documentId,sectionCode,paragraph] as JSON-array text.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| documentId | Document Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| sectionCode | Section Code | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| paragraph | Paragraph | Required. Safe integer; minimum 1. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| token | Token | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"documentId": "D17",
"sectionCode": "S3",
"paragraph": 4
},
"output": {
"token": "[\"D17\",\"S3\",4]"
}
}Limitations and assumptions
- No document, section, paragraph bound, edition, interpretation or citation accuracy is verified.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Read the original passage and relevant edition with the stated interpretive and editorial conventions. Verify source context and attribution before reuse; local span labels and interpretation-objection pair keys organize records without evaluating the argument or granting quotation rights.
References
Similar or alternative tools
- Citation Locator Edition Disambiguator
Build an edition-qualified citation locator from explicit work, edition and locator text.
- Critical Reading Annotation Span Label
Label an annotation's supplied half-open offset span and length.