aframe icon indicating copy to clipboard operation
aframe copied to clipboard

Export all glitches before 8th July

Open vincentfretin opened this issue 6 months ago • 6 comments

List of glitches used in documentation

hello world template:

  • [ ] https://glitch.com/~aframe in README.md docs/introduction/hosting-and-publishing.md docs/introduction/index.md CONTRIBUTING.md and in src/_data/examples.yml aframe-site

aframe-registry and aincraft, the examples were already ported in the repo, need to fix those links:

  • [x] https://glitch.com/edit/#!/aframe-registry in README.md docs/introduction/entity-component-system.md docs/introduction/installation.md
  • [x] https://glitch.com/~aframe-aincraft in docs/introduction/faq.md docs/introduction/installation.md

naf:

  • [x] https://glitch.com/~networked-aframe in docs/introduction/installation.md -> https://stackblitz.com/github/networked-aframe/naf-project but I just removed the link

animated lights:

  • [ ] [exported] https://glitch.com/edit/#!/aframe-school-js in docs/introduction/javascript-events-dom-apis.md
  • [x] https://glitch.com/edit/#!/aframe-animated-lights in docs/introduction/javascript-events-dom-apis.md docs/core/mixins.md docs/introduction/entity-component-system.md docs/core/mixins.md docs/components/light.md

interactions-and-controllers:

  • [x] https://glitch.com/edit/#!/aframe-basic-interaction in docs/introduction/interactions-and-controllers.md (dead, removed from examples)
  • [x] https://glitch.com/edit/#!/wide-cream in docs/introduction/interactions-and-controllers.md (broken links from vr.google.com, removed from examples)
  • [ ] [exported] https://glitch.com/~aframe-event-set-component in docs/introduction/interactions-and-controllers.md
  • [ ] [exported] https://glitch.com/~aframe-school-cursor-handler/ in docs/introduction/interactions-and-controllers.md

systems:

  • [ ] [exported] https://glitch.com/~aframe-refraction-system in docs/core/systems.md

animation:

  • [ ] [exported] https://glitch.com/edit/#!/aframe-animation-events in docs/components/animation.md
  • [ ] [exported] https://glitch.com/~aframe-shooting-stars in docs/components/animation.md

material:

  • [x] [404] https://glitch.com/edit/#!/aframe-displacement-shader in docs/components/material.md
  • [ ] [exported] https://glitch.com/edit/#!/aframe-simpler-shader in docs/components/material.md
  • [ ] [exported] https://glitch.com/edit/#!/aframe-displacement-registershader in docs/components/material.md
  • [ ] [exported] https://glitch.com/edit/#!/aframe-displacement-offset-registershader in docs/components/material.md
  • [ ] [exported] https://glitch.com/edit/#!/aframe-texture-shader in docs/components/material.md

modify-model-material:

  • [x] https://glitch.com/edit/#!/aframe-modify-model-material in docs/components/obj-model.md docs/components/gltf-model.md docs/introduction/models.md

geometry:

  • [ ] [exported] https://glitch.com/edit/#!/ex-2-geometry in docs/components/geometry.md
  • [ ] [exported] https://glitch.com/edit/#!/ex-2a-texture-on-shape in docs/components/geometry.md
  • [ ] [exported] https://glitch.com/edit/#!/ex-2b-shape-as-entity in docs/components/geometry.md
  • [ ] [exported] https://glitch.com/edit/#!/ex-2c-animating-shapes in docs/components/geometry.md
  • [ ] [exported] https://glitch.com/edit/#!/ex-2d-animating-shapes-with-components in docs/components/geometry.md

sky:

  • [ ] [exported] https://glitch.com/edit/#!/aframe-adding-a-sky in docs/primitives/a-sky.md
  • [ ] [exported] https://glitch.com/edit/#!/aframe-changing-the-sky in docs/primitives/a-sky.md

misc:

  • [x] https://glitch.com/~aframe-gallery in docs/introduction/installation.md
  • [x] https://aframe-360-gallery.glitch.me in docs/introduction/best-practices.md
  • [ ] [exported] https://glitch.com/~aframe-vaporwave in docs/introduction/installation.md also see #4456
  • [ ] [exported] https://glitch.com/edit/#!/a-frame-mouse-click-example in docs/components/cursor.md
  • [ ] [exported] https://glitch.com/~aframe-text-fonts-demo in docs/components/text.md
  • [ ] [exported] https://glitch.com/edit/#!/aframe-360-video-example in docs/primitives/a-videosphere.md
  • [ ] [exported] https://glitch.com/~aframe-basic-guide-with-environment in docs/guides/building-a-basic-scene.md
  • [x] Remove ref in examples/mixed-reality/watch/hand-menu.js
  • [x] Move putter-grip asset in assets repo examples/test/model/index.html
  • [x] Change url in test tests/core/a-assets.test.js

All those can be exported in a single repo aframevr/glitch-examples for example and we can update the urls in the doc to use: https://stackblitz.com/github/aframevr/glitch-examples/tree/main/ex-2c-animating-shapes

@dmarcos what are the glitches you have access to so you can easily click on the Download button in the dashboard? Otherwise we need to download each file one by one.

vincentfretin avatar Jun 16 '25 11:06 vincentfretin

The assets are not in the archive when you download a project from the dashboard. Here is what I used for some projects to get the code, all assets and change the urls:

mkdir public/assets                                                                  
cd public/assets                                                                     
for f in `jq .url ../../.glitch-assets|grep -v "^null$"|sed 's@"\(.*\)"@\1@'|sort -u`; do wget $f; done
cd ../..                                                                        
sed -i 's@"https://cdn.glitch.global/.*/\(.*\)?.*"@"./assets/\1"@' public/*.html 

vincentfretin avatar Jun 16 '25 11:06 vincentfretin

The examples can also be integrated into this repo in docs like @diarmidmackenzie did in:

  • #5211
  • #5213
  • #5214
  • #5215

I see some glitches actually already have been moved to docs, but there are still some links to the glitch in the docs.

vincentfretin avatar Jun 16 '25 12:06 vincentfretin

We discussed it already in #5207 so that issue is really to export the glitch content before the 8th July, then we can handle each example one by one.

vincentfretin avatar Jun 16 '25 12:06 vincentfretin

The hello world example directly from the aframe repo: https://stackblitz.com/github/aframevr/aframe/tree/gh-pages/examples/boilerplate/hello-world?file=index.html (I got an error today, the webcontainer doesn't spawn) same with codesandbox: https://codesandbox.io/s/github/aframevr/aframe/tree/gh-pages/examples/boilerplate/hello-world?file=index.html You need to replace ../../../dist/aframe-master.min.js by https://aframe.io/releases/1.7.1/aframe.min.js for it to work. In the examples in docs we have

    <!-- If running this example without a local copy of A-Frame, replace this next line with:
    <script src="https://aframe.io/releases/<release_number>/aframe.min.js"></script>
    -->
    <script src="../../../dist/aframe-master.js"></script>

Currently in the preghpages script, we're replacing aframe-master.js by aframe-master.min.js but I think it would be better to replace it with the aframe.io url of the latest release. That way we can use stackblitz or codesandbox to open any examples.

vincentfretin avatar Jun 18 '25 08:06 vincentfretin

Thanks so much for compiling the list

dmarcos avatar Jun 18 '25 22:06 dmarcos

I uploaded all the exported glitches to my Google Drive, zip is 45 MB https://drive.google.com/file/d/1Bb1HyJFXyVoJT-llu-P-OWRJuhxsGWYa/view?usp=sharing

vincentfretin avatar Oct 01 '25 07:10 vincentfretin