This repository contains my three.js sketches; basically, anything I have created with the library that I find cool! They are all displayed on 👉 this website 👈.
Visit the website to see all of my sketches! Here are just a selected few.
sketches/
: My three.js sketches, one for each sub-directoryassets/
: Contains shared CSS files, fonts, textures, images, etc.three.js/
: A portion of the three.js repository needed by the sketcheslib/
: Contains other shared libraries, frameworks, and JavaScript filescommon/
: Contains templates_data/
,_layouts/
,_posts
,_config.yml
,index.md
,Gemfile
,Gemfile.lock
: Directories and files that you know very well if you've ever worked with a Jekyll websiteREADME.md
: The document you are reading- The rest of the files at the root directory: Various configuration files used by Git, NPM, and what not
You can run the website locally if you want to (say, you've lost your Internet connection and you are bored). Fire up a command line and get ready!
The website is generated using Jekyll. Jekyll is a Ruby gem, so you need to have a Ruby development environment installed (see this page to receive specific requirements and guides). Once you've got that installed, you need to install the Bundler gem - which is needed to install dependencies - with:
# Before you enter this command, you must have Ruby installed
gem install bundler
git clone https://github.com/you-create/three.js-sketches.git # Clone the repository
cd three.js-sketches # Navigate into the repository's directory
bundle install --path bundle # Install dependencies required to build the website
Once you've got yourself a clone of the repository and installed the dependencies, just navigate into the clone's directory and run:
bundle exec jekyll serve
Then open your web browser and go to localhost:4000. Stop running with Ctrl + C. Every time you need to view the website locally, that is the only command you have to execute.
To get new sketches and latest updates, do:
git pull origin master
Copyright ©️ Nguyen Hoang Duong ([email protected]).
Currently the source code is not licensed and is meant for educational purposes. See this page by GitHub to know what you are supposed to do. However, I'm considering a Creative Commons license, and I will make my final decision as soon as possible. You can suggest a better license for this project by opening a new issue.
A number of sketches also use resources that are not mine. For any such sketch, see the Acknowledgements section of that sketch's page for attributions and detailed licensing information.