This repository is open-sourced to make the mechanics of building the website easily copyable for other research infrastructures.
If you are a part of the Australian Digital Observatory ARDC Platform and wish to contribute website content but do not have access, please contact digitalobservatory@qut.edu.au with your node affiliation and GitHub username, and you will be added to the repository.
In order to run the Lektor local development server you will need:
- A command-line terminal/shell - Git Bash or Anaconda Prompt should work fine for Windows users
- Python 3 installed and usable
- Recommended: a dedicated Python virtual environment set up, such as an Anaconda/Conda environment or any virtualenv-based environment.
- Install Lektor
- If you do not have push access to
https://github.com/QUT-Digital-Observatory/australian_digital_observatory_site, you
will need to fork that repository and do the following using your fork on GitHub
as the
origin
remote. See Atlassian's Forking Workflow Tutorial for context. - Clone this repository locally
- In your command line, navigate to your local repository (the folder this readme is in)
- Change to the 'Australian Digital Observatory' folder within that folder:
> cd 'Australian Digital Observatory'
- Run the Lektor local development server:
> lektor server
- The output of the
lektor server
command will give you a URL that will be similar tohttp://127.0.0.1:5000/
. Open that address in your web browser to see the site in its fully built form. As you make any changes to the files in the repository, the site at this address will be automatically updated with those changes. - When you are done with the server, you can shut it down with the keyboard shortcut Ctrl+C on most platforms (when you have the command line terminal the server is running in in focus).
- With the local development server running as above, go to the admin URL - e.g.
http://127.0.0.1:5000/admin/
- You can use this UI to edit and add content as you wish. All changes will be reflected in changes to the files in your local repository
- When you're ready to submit your changes, create a new git branch and commit all
changed files, then push your changes to the GitHub repository. If you're using git
on the command line, the commands will be:
> git switch -c [meaningful name for new branch] > git commit -am "[short description of changes]" > git push origin [name of the branch you just created]
- Create a pull request on GitHub against the
main
branch. If you forked the repository in your initial setup, ensure your pull request is against themain
branch of the Digital Observatory organisation's version of the repository.
The Australian Digital Observatory website is published on GitHub Pages, using a custom domain.
The site build and deploy process is run on GitHub Actions, with .github/workflows/publish.yml
.
This workflow calls lektor build
to produce the static site whenever changes are merged to the
main
branch in the GitHub repository, and then commits the static site files to the gh_pages
branch.
The gh_pages
branch should not be modified by any other process than by this GitHub action.
The digitalobservatory.net.au domain is managed by the QUT Digital Observatory, and DNS records must be configured with the domain name provider to point to the GitHub pages server as appropriate.
Configuration of the domain on the GitHub side requires the CNAME
file to be in the repository
(including in the gh_pages
branch).
See the GitHub documentation for more information as to how to (re)configure the domain.
The code in this repository used to generate this site is licensed under the MIT open source license. We welcome other projects using our website process as a starting point to develop their own sites.
The content of the website (i.e. the resource descriptions and the contents of the
gh-pages
branch) are licensed under CC BY 4.0.