Home / How-to / Make a reading-list link
How-to
Make a reading-list link
A list is a link. Make it with the page, or type it.
With the make page
Open newsroom.sgit.ai/for/make.html. Search the articles, add up to fifty, move them up and down, mark some as worth a look rather than to read, name yourself and the reader, write a note, and copy the link. The preview shows the list exactly as the recipient will see it, because the page reads its own link back through the recipient's parser. Every article page also has a start a reading list with it link at its foot, which opens the make page with that article in it.
By hand
https://newsroom.sgit.ai/for/#from=Dinis&to=Steve&r=78,42,15&s=66&n=Read%2078%20first
r is the articles to read, in order, by number; s is worth a look; from and to are names; n is a note. The numbers are in articles/ids.json, and each article prints its own (Article No. 78). The rules, field by field: the reading-list link.
What the recipient sees
The list, with each article's title, date and teaser, in the order you gave; your note; a Reply button if you gave an address. Opening it adds a visitor persona named for the list, which they can keep or remove; nothing is charged for opening it. Anything malformed in the link is dropped and listed under Left out, so a mangled link still opens.
For a site
Two pages that import from this host, and a numbers file:
- Publish
articles/ids.jsonwith a stablenper article (never changed or reused). for/index.html:import { openList } from 'https://api.newsroom.sgit.ai/v0.2.5/for/reading-list.js'and callopenList({ core, ids: '../articles/ids.json', root: '../', mount })withcorethe meter core's URL on this host. Loadfor/for.cssfrom this host too.for/make.html: the same withmakeListfromfor/make.jsandsite: 'https://your-site/for/', the address the links will carry.
The newsroom's admin/build/lists.py writes both pages; copy it or the pages it writes.