Skip to content

aframevr/aframe-site

Repository files navigation

aframe-site

Powers the A-Frame Site.

This site is built using hexo. Site content is written in Markdown (and located in the src/ directory). Pull requests are welcome!

Local Development

Clone this repository:

git clone [email protected]:aframevr/aframe-site.git && cd aframe-site

To install the dependencies and start the local development server:

npm install && npm run installdocs && npm start

If you are testing something related to the A-Frame examples, you can set up local configuration settings to point the examples to your local A-Frame examples:

cp _config.local.yml.dist _config.local.yml

Then load http://localhost:4000/!

You may need to occasionally need to restart the server if you cause breaking changes. Just proceed as usual. When developing on the site scripts, generators, and helpers in scripts/, you will need to restart the server on every change.

Testing Documentation

Documentation lives in the A-Frame GitHub repo.

First, clone the A-Frame GitHub repo.

cd aframe
npm link

And then link aframe-site to aframe:

cd aframe-site
npm link aframe

Then the master documentation will update as you work on them from the A-Frame repository. This works because we have pointed the A-Frame site, via a soft symbolic link, to the documentation installed in node_modules/aframe/docs/.

Old versions of documentation are handled through multidep.json. Run npm run bumpdocs to try to pull the latest documentation from GitHub branches (e.g., aframevr/aframe#docs-v0.3.0).

Deployment

Push changes to GitHub, and @a-frobot will automatically deploy the site.

Search

The documentation search service is hosted by Algolia DocSearch. The old indexing / crawling configuration (v2) can be found at the DocSearch config repo as historical reference.

The new index / crawler configuration (v3) can be found in this repo

In order to use the old style docsearch with the new algolia client we're using a fork and the build is self-hosted

Credits

Source adopted from Vue's site.

License

Licensed under The MIT License.