Giter Club home page Giter Club logo

Comments (12)

llemeurfr avatar llemeurfr commented on June 2, 2024

A few proposals:

  • Fragment or Region or Box -> replaces the terme Page (CSS fragmentation module -> fragmentation container).
  • Index or Position -> replaces the term Page Number.
  • Percentage -> position expressed as a percentage, in the publication.

from architecture.

HadrienGardeur avatar HadrienGardeur commented on June 2, 2024

Right now we're using:

  • "page" for the equivalent of Adobe's creation
  • "position" to provide an overall progression in % (expressed as a float between 0 and 1)

I agree that page can be confusing and would love to see a better term for it, but I haven't seen convincing proposals IMO so far.

Any other ideas?

from architecture.

llemeurfr avatar llemeurfr commented on June 2, 2024

I have discussed this with Alexandre yesterday, and we settled internally on:

  • "region" for the synthetic page, as it implicitly conveys the concept of rectangle screen region;
  • "index" for the notion of page number, as it is indeed an index referencing individual regions.

For an overall progression in %, I would favor the term "progression".

from architecture.

danielweck avatar danielweck commented on June 2, 2024

I think we also need to clarify the terms "references" and "locators".

from architecture.

danielweck avatar danielweck commented on June 2, 2024

I like "progression" better than "position" (% [0 ... 1]).

from architecture.

danielweck avatar danielweck commented on June 2, 2024

The term "region" is overused (e.g. Regions Of Interest in EPUB3 Adaptive Layout).
Plus, I don't think we should attempt to define document fragments as contiguous "ranges of content", but instead as an ordered sequence of "breaks" (i.e. boundaries, such as EPUB3 epub:type="pagelist" and epub:type="page-break"). This way, a navigation hyperlink to a given "break" actually re-positions the reader at the beginning of the desired stream of content to read (unlike printed page numbers which are traditionally visually located at the bottom / after the range of content corresponding to that page).

from architecture.

llemeurfr avatar llemeurfr commented on June 2, 2024

Not sure I understand. In reflow mode, the CSS columns trick produces "ranges of content" that appear on the screen, and we tend to call that a "page", with is really overused because the page-breaks also define "page" separators. The "region" proposal is a simple alternative to this false "page". Do you think we should not define any term for this? we name it every day ...

from architecture.

HadrienGardeur avatar HadrienGardeur commented on June 2, 2024

I also find region overused and confusing with both Regions of Interest (EPUB) and CSS Regions.

I'm not quite convinced about index either, it has the potential to be as confusing as page.

If we rename "position" into "progression", could we use "position" instead of "page"?

from architecture.

danielweck avatar danielweck commented on June 2, 2024

Bearing in mind, I am not talking about end-user terminology, but naming conventions for low-level data / properties generated by the "arbitrary content fragmentor" (aka "paginator" service) which produces a sequence of "breaks" (atomic precise locations within the primary linear reading flow). The concept of "range of content" can be extrapolated if needed, for example to determine whether a particular HTML fragment (p, div, etc.) is fully or partially contained between two consecutive break boundaries.

from architecture.

danielweck avatar danielweck commented on June 2, 2024

I too prefer position instead of page or index.

from architecture.

llemeurfr avatar llemeurfr commented on June 2, 2024

If the context is not the display level but the lower paginator level, I'm ok with position for expressing this kind of separator between fragments and progression for expressing a %.

from architecture.

HadrienGardeur avatar HadrienGardeur commented on June 2, 2024

Great, this issue is now resolved.

from architecture.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.