search

w3c / json-ld-wg

Documentation for the JSON-LD Working Group
https://www.w3.org/2018/json-ld-wg/
Other
29 stars 24 forks source link

Update the WG Home page #151

Closed iherman closed 4 years ago

iherman commented 4 years ago

Updating the publication snapshot and the home page, with also a reference to the JSON-LD 1.1 EPUB 3 volume.

This PR should be merged when the Rec-s are published, not before!

davidlehn commented 4 years ago

Should the epub file be versioned in some way?

To be honest, I'm not even sure how to view a 434KB .epub file! Is this format better for some use case than, say, a single file HTML?

iherman commented 4 years ago

Should the epub file be versioned in some way?

That makes sense. We can

although the second is a bit of a mouthful:-(

To be honest, I'm not even sure how to view a 434KB .epub file! Is this format better for some use case than, say, a single file HTML?

There are a bunch of EPUB readers out there, the quality of some of them is such that they don't do a perfect rendering (in many respects, these W3C documents produce bleeding edge EPUB 3, but an upcoming WG will hopefully make things better). If you are on a Mac, you can load it into the built-in Books app, that would also work on iPhone and Ipad. On Mac or Windows the Thorium reader is a pretty good alternative (that is what I use for these).

There is no such thing as a single HTML alternative for all four documents (the core specs plus streaming). But I suspect that if there was one, it would pretty much stretch the browsers. The book also contains a unified table of content for all four documents, it is one single file that you can move around easily among the different machines and can be read off-line and, for very long documents I always find the paginated view better. But that is a matter of taste.

gkellogg commented 4 years ago

On Jul 9, 2020, at 9:53 PM, Ivan Herman notifications@github.com wrote:

 Should the epub file be versioned in some way?

That makes sense. We can

set it to jsonld1.1.epub set it to jsonld1.1.2020.06.16.epub although the second is a bit of a mouthful:-(

I would have thought it to be unnecessary, as it’s located at a versioned URL.

Gregg

To be honest, I'm not even sure how to view a 434KB .epub file! Is this format better for some use case than, say, a single file HTML?

There are a bunch of EPUB readers out there, the quality of some of them is such that they don't do a perfect rendering (in many respects, these W3C documents produce bleeding edge EPUB 3, but an upcoming WG will hopefully make things better). If you are on a Mac, you can load it into the built-in Books app, that would also work on iPhone and Ipad. On Mac or Windows the Thorium reader is a pretty good alternative (that is what I use for these).

There is no such thing as a single HTML alternative for all four documents (the core specs plus streaming). But I suspect that if there was one, it would pretty much stretch the browsers. The book also contains a unified table of content for all four documents, it is one single file that you can move around easily among the different machines and can be read off-line and, for very long documents I always find the paginated view better. But that is a matter of taste.

— You are receiving this because your review was requested. Reply to this email directly, view it on GitHub, or unsubscribe.

iherman commented 4 years ago

That makes sense. We can

set it to jsonld1.1.epub set it to jsonld1.1.2020.06.16.epub although the second is a bit of a mouthful:-(

I would have thought it to be unnecessary, as it’s located at a versioned URL.

Not this one. We indeed have EPUB versions for each document whose links and locations are alongside the Rec document itself. But those are an EPUB per document. The one we are talking about in this issue is the EPUB containing all four documents as one volume, and located on the WG's web site.