StellarDynamics

StellarDynamics is an application for operating motor-controlled clock-drive systems for tracking celestial objects.

Full documentation is available on https://303adastra.github.io/stellardynamics/.

View the documentation locally

You can run your own local server to view the documentation site on a local desktop:

Note: It is recommended you run the following instructions on a Linux/Unix-like operating system. If you are on a Windows machine, consider installing Windows Subsystem for Linux.

Installing requirements

You will need git to clone the project contents and docker to run the docker image that contains the dependencies needed for building and serving the documentation.

git.
docker.

Cloning the repo

Clone the StellarDynamics repo. Don’t forget to use --recurse-submodules flag, or else you won’t pull down some of the code you need to generate a working site.

git clone --recurse-submodules https://github.com/303adastra/stellardynamics.git
cd stellardynamics

Note: If you accidentally cloned without using --recurse-submodules, you can run git submodule update --init --recursive to pull down submodules needed to generate a working site.

Building project dependencies

Once you’ve cloned the repo & installed docker, run the buildDocs.sh script in the project root directory (Note: Linux users may need to prepend this command sudo). This will build a docker image, as well as install node modules, needed to locally run the stellardynamics Hugo webserver. Once the image is built and stored on your machine, you do not need to rerun this step. You can view all locally installed images by running docker images.

./buildDocs.sh

Running local server

Run the serve.sh script in the project root directory (Note: Linux users may need to prepend this command sudo). By default, your site will be available at http://localhost:1313/stellardynamics.

./serve.sh

Now that you’re serving your site locally, the Hugo webserver will watch for changes to the content and automatically refresh your site.