Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Initial version of glTF spec in asciidoctor format #1901

Merged
merged 62 commits into from
Sep 23, 2021
Merged

Commits on Nov 10, 2020

  1. Initial rough cut

    Significant remaining TBD:
    
    Math markup
    Greek letter attributes - define & expand in [source]
    Tables
    Links (https references)
    Internal xrefs/anchors
    Citations/references
    Appendix titles / formats
    Odd bit-packing diagrams
    Figure out how to dynamically? incorporate REFERENCE.adoc (would be by
        far easiest to statically generate it from wetzel repository and
        commit here - can't imagine it will often change).
    oddhack committed Nov 10, 2020
    Configuration menu
    Copy the full SHA
    10e7b3a View commit details
    Browse the repository at this point in the history
  2. Clean up tables

    oddhack committed Nov 10, 2020
    Configuration menu
    Copy the full SHA
    1a56109 View commit details
    Browse the repository at this point in the history

Commits on Nov 11, 2020

  1. Fix format of http links.

    Add anchors to sections, matching titles (might also match Asciidoc default behavior if no explicit anchor).
    Remove some extraneous  
    oddhack committed Nov 11, 2020
    Configuration menu
    Copy the full SHA
    69cc009 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    1ed0a8e View commit details
    Browse the repository at this point in the history
  3. minor formatting cleanup

    oddhack committed Nov 11, 2020
    Configuration menu
    Copy the full SHA
    e7f69b8 View commit details
    Browse the repository at this point in the history
  4. Replace a couple of link references with the master glTF branch in

    github, rather than the local repository branch (since there may not be
    a local branch, depending on how the spec is built and viewed - and the
    master branch registry should be canonical, as well).
    oddhack committed Nov 11, 2020
    Configuration menu
    Copy the full SHA
    ea1775e View commit details
    Browse the repository at this point in the history
  5. Math test

    oddhack committed Nov 11, 2020
    Configuration menu
    Copy the full SHA
    46943e9 View commit details
    Browse the repository at this point in the history

Commits on Nov 12, 2020

  1. Configuration menu
    Copy the full SHA
    b48ec6a View commit details
    Browse the repository at this point in the history

Commits on Nov 13, 2020

  1. Initial cut at a working asciidoctor version of the glTF spec. Includes

    Makefile for building and intermediate generated files, and tweakups
    markup of the math-rendering URLs to work properly with asciidoctor.
    oddhack committed Nov 13, 2020
    Configuration menu
    Copy the full SHA
    c35b9d8 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    1052a8f View commit details
    Browse the repository at this point in the history
  3. Configuration menu
    Copy the full SHA
    a8c7229 View commit details
    Browse the repository at this point in the history

Commits on Nov 15, 2020

  1. Configuration menu
    Copy the full SHA
    afc659d View commit details
    Browse the repository at this point in the history

Commits on Nov 17, 2020

  1. Configuration menu
    Copy the full SHA
    1c3bb69 View commit details
    Browse the repository at this point in the history
  2. Merge changes from #1749

    emackey committed Nov 17, 2020
    Configuration menu
    Copy the full SHA
    0d27971 View commit details
    Browse the repository at this point in the history

Commits on Nov 18, 2020

  1. Configuration menu
    Copy the full SHA
    da2c098 View commit details
    Browse the repository at this point in the history

Commits on Nov 19, 2020

  1. Add missing [appendix] tags so they get appendix letters, not chapter…

    … numbers
    
    Use npx to invoke wetzel now that it's in npm (@donmccurdy)
    oddhack committed Nov 19, 2020
    Configuration menu
    Copy the full SHA
    6f2dc0e View commit details
    Browse the repository at this point in the history

Commits on Nov 20, 2020

  1. Remove the generated SingleSpec.adoc target, since we've decided not to

    host the generated specification on github and are not constrained by
    the limitations of its asciidoctor implementation.
    
    Also cleans up the Makefile a bit to explain the wetzel invocation and
    the URL argument to it ($(SCHEMALINK)).
    oddhack committed Nov 20, 2020
    Configuration menu
    Copy the full SHA
    4580781 View commit details
    Browse the repository at this point in the history
  2. Remove checked-in generated target.

    Try to use Github Actions for CI test that builds the spec targets.
    oddhack committed Nov 20, 2020
    Configuration menu
    Copy the full SHA
    8dbd8e3 View commit details
    Browse the repository at this point in the history
  3. Run in right directory

    oddhack committed Nov 20, 2020
    Configuration menu
    Copy the full SHA
    e05fc82 View commit details
    Browse the repository at this point in the history
  4. Configuration menu
    Copy the full SHA
    4489751 View commit details
    Browse the repository at this point in the history
  5. Configuration menu
    Copy the full SHA
    5c1b8de View commit details
    Browse the repository at this point in the history
  6. Configuration menu
    Copy the full SHA
    90e5136 View commit details
    Browse the repository at this point in the history

Commits on Nov 23, 2020

  1. Configuration menu
    Copy the full SHA
    a80a276 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    23bfb8c View commit details
    Browse the repository at this point in the history

Commits on Nov 24, 2020

  1. Add JSON schemas to AsciiDoctor output.

    With help from CesiumGS/wetzel#51
    emackey committed Nov 24, 2020
    Configuration menu
    Copy the full SHA
    87cb6b0 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    7d0f07f View commit details
    Browse the repository at this point in the history
  3. Merge pull request #1907 from KhronosGroup/ed-adoc-embed

    Add JSON schemas to AsciiDoctor output.
    oddhack committed Nov 24, 2020
    Configuration menu
    Copy the full SHA
    90751fb View commit details
    Browse the repository at this point in the history
  4. Configuration menu
    Copy the full SHA
    a44dc1b View commit details
    Browse the repository at this point in the history
  5. Lock version of wetzel

    See discussion:
    #1907 (comment)
    emackey committed Nov 24, 2020
    Configuration menu
    Copy the full SHA
    0aeb27a View commit details
    Browse the repository at this point in the history

Commits on Nov 28, 2020

  1. This modifies the Asciidoctor HTML & PDF specs to compare asciidoctor

    latexmath rendering vs. the image approaches previously used. See the
    generated HTML / PDF in the Actions artifacts download and search for
    "Latexmath" (followed by "Old") versions of each equation.
    
    Relevant points:
    
    * The HTML output is not self-contained. It introduces an external dependency on the MathJax package on a CDN outside our control.
    * MathJax runs after the HTML page is loaded and takes noticeable time - initially you will see the raw latex markup, replaced and re-laid-out with the formatted math.
    * The PDF output introduces a new dependency on the asciidoctor-mathematical gem (the Khronos Docker image already has this).
    * The PDF math rendering quality is noticeably lower than the HTML rendering quality.
    oddhack committed Nov 28, 2020
    Configuration menu
    Copy the full SHA
    fbdde31 View commit details
    Browse the repository at this point in the history

Commits on Dec 2, 2020

  1. Configuration menu
    Copy the full SHA
    3702605 View commit details
    Browse the repository at this point in the history
  2. Merge pull request #1909 from KhronosGroup/stem-math

    Compare latexmath to image math rendering in asciidoctor branch
    oddhack committed Dec 2, 2020
    Configuration menu
    Copy the full SHA
    b2c9f74 View commit details
    Browse the repository at this point in the history
  3. Fix two citations. The Burley2012 reference was a dead link to a cloud

    document; revised to what appears to be a stable location at Disney. The
    Pharr citation was mis-dated; the 3rd edition of the book was published
    in 2016, not 2018 (although the website lists 2018 as the latest
    copyright date).
    
    In principle these changes belong in the currently canonical Markdown
    spec as well, but they're trivial changes and probably can just be
    deferred to when the WG switches over to the asciidoctor markup.
    oddhack committed Dec 2, 2020
    Configuration menu
    Copy the full SHA
    b3dc81f View commit details
    Browse the repository at this point in the history
  4. Configuration menu
    Copy the full SHA
    6c6ef27 View commit details
    Browse the repository at this point in the history
  5. Configuration menu
    Copy the full SHA
    4458c7a View commit details
    Browse the repository at this point in the history
  6. Configuration menu
    Copy the full SHA
    fdea3da View commit details
    Browse the repository at this point in the history
  7. Minor labeling changes

    RealismCloud committed Dec 2, 2020
    Configuration menu
    Copy the full SHA
    a8598f6 View commit details
    Browse the repository at this point in the history

Commits on Dec 3, 2020

  1. Merge pull request #1917 from DrX3D/jon-adoc

    Sectioned hanging text
    emackey committed Dec 3, 2020
    Configuration menu
    Copy the full SHA
    a151b9e View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    6944dd3 View commit details
    Browse the repository at this point in the history
  3. Configuration menu
    Copy the full SHA
    e1ea8f6 View commit details
    Browse the repository at this point in the history
  4. Put glTF logo on PDF title page

    See #1901 (comment)
    
    Note: doing this for HTML is harder.
    oddhack committed Dec 3, 2020
    Configuration menu
    Copy the full SHA
    c772244 View commit details
    Browse the repository at this point in the history
  5. Configuration menu
    Copy the full SHA
    11fd09e View commit details
    Browse the repository at this point in the history
  6. Merge pull request #1919 from KhronosGroup/reorg-adoc

    Flip credits & copyrights
    emackey committed Dec 3, 2020
    Configuration menu
    Copy the full SHA
    d78e65b View commit details
    Browse the repository at this point in the history
  7. Configuration menu
    Copy the full SHA
    9d514db View commit details
    Browse the repository at this point in the history
  8. Configuration menu
    Copy the full SHA
    d8b8b9a View commit details
    Browse the repository at this point in the history

Commits on Dec 18, 2020

  1. Configuration menu
    Copy the full SHA
    7420e21 View commit details
    Browse the repository at this point in the history

Commits on Jul 20, 2021

  1. Update normative language (#1997)

    Co-authored-by: Ed Mackey <elm19087@gmail.com>
    lexaknyazev and emackey committed Jul 20, 2021
    Configuration menu
    Copy the full SHA
    94ed681 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    522d506 View commit details
    Browse the repository at this point in the history

Commits on Jul 29, 2021

  1. Configuration menu
    Copy the full SHA
    8e6aa7d View commit details
    Browse the repository at this point in the history

Commits on Aug 16, 2021

  1. Configuration menu
    Copy the full SHA
    bb537b3 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    7fbcc52 View commit details
    Browse the repository at this point in the history

Commits on Aug 20, 2021

  1. Configuration menu
    Copy the full SHA
    061997b View commit details
    Browse the repository at this point in the history

Commits on Sep 13, 2021

  1. Configuration menu
    Copy the full SHA
    45b308e View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    839ca79 View commit details
    Browse the repository at this point in the history

Commits on Sep 22, 2021

  1. Integrate latest AsciiDoc updates (#2028)

    * Integrate latest updates
    
    * More typography fixes
    
    * Apply suggestions from code review
    
    Co-authored-by: Gary Hsu <bghgary@users.noreply.github.com>
    
    * Address feedback
    
    * Address feedback & add more clarifications
    
    * Address feedback
    
    Co-authored-by: Gary Hsu <bghgary@users.noreply.github.com>
    lexaknyazev and bghgary committed Sep 22, 2021
    Configuration menu
    Copy the full SHA
    7748663 View commit details
    Browse the repository at this point in the history
  2. 1 Configuration menu
    Copy the full SHA
    4399139 View commit details
    Browse the repository at this point in the history

Commits on Sep 23, 2021

  1. Update PBR links

    lexaknyazev committed Sep 23, 2021
    Configuration menu
    Copy the full SHA
    ac0d679 View commit details
    Browse the repository at this point in the history
  2. Configuration menu
    Copy the full SHA
    9757259 View commit details
    Browse the repository at this point in the history
  3. Configuration menu
    Copy the full SHA
    e2bd348 View commit details
    Browse the repository at this point in the history
  4. Add REUSE license checker and CI check to new glTF 2.0 branch (#2029)

    * Add license text of all licenses used under LICENSES/.
    * Add copyright statements that are readable by REUSE where reasonably possible.
    * Add .reuse/dep5 entry as fallback licenses for images etc. where explicit copyrights not possible.
    * Add 'reuse lint' check to github Actions CI
    * Use 'TBD' license on vendor extensions, none of which seem to have explicit licenses and may not be owned by Khronos.
    * Some minor whitespace / EOL convention changes.
    * Add boilerplate files missing from repo such as CONTRIBUTING and COPYING.
    oddhack committed Sep 23, 2021
    Configuration menu
    Copy the full SHA
    5d3dfa4 View commit details
    Browse the repository at this point in the history
  5. Configuration menu
    Copy the full SHA
    2326f4b View commit details
    Browse the repository at this point in the history
  6. Add GitHub-specific note

    lexaknyazev committed Sep 23, 2021
    Configuration menu
    Copy the full SHA
    3e249b3 View commit details
    Browse the repository at this point in the history