Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New documentation site built with Material for MkDocs #186

Merged
merged 64 commits into from
Jul 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
64 commits
Select commit Hold shift + click to select a range
3af1900
Add new MkDocs project with Material theme
thobson88 Apr 7, 2024
60702ef
Add Material features
thobson88 Apr 8, 2024
2f317cd
Update colour palette & logo
thobson88 Apr 8, 2024
4a51f49
Increase logo size
thobson88 Apr 8, 2024
5b87840
Add navigation plugin and Use Cases page
thobson88 Apr 8, 2024
48591a4
Add favicon
thobson88 Apr 8, 2024
cc78906
Add technical notes, FAQs and placeholder pages
thobson88 Apr 8, 2024
6de6148
Add Roles and Usage pages
thobson88 Apr 8, 2024
a82765f
Add contributing notes & update useful links
thobson88 Apr 8, 2024
b19f6d1
Re-include search bar
thobson88 Apr 8, 2024
833a814
Fix FAQ page formatting
thobson88 Apr 24, 2024
9de277b
Add installation steps in Getting Started page
thobson88 Apr 24, 2024
c5ed394
Add Trustchain Mobile section on front page
thobson88 Apr 24, 2024
96b1d7c
Add text on Use Cases page
thobson88 Apr 24, 2024
c2d8302
Add Glossary page and (draft) ION installation notes
thobson88 Apr 24, 2024
0740710
Add (draft) Dev Guide notes
thobson88 Apr 24, 2024
18f715f
Remove quotes from root_event_time config param
thobson88 Jul 7, 2024
fa920f7
Undo last commit
thobson88 Jul 7, 2024
71c1b0d
Add CLI usage & configuration instructions
thobson88 Jul 7, 2024
b5460d0
Add whitespace at page bottoms
thobson88 Jul 7, 2024
0be3645
Hide deployment, glossary, dev-guide pages
thobson88 Jul 7, 2024
c74eccc
Fix link
thobson88 Jul 7, 2024
36b30b2
Update descriptions of four use cases
thobson88 Jul 7, 2024
41a31a2
Add link to BBC QR code scam video
thobson88 Jul 8, 2024
6a6cde5
Add more notes on the publish.sh script
thobson88 Jul 8, 2024
a0b6787
Minor text edits and fixes
thobson88 Jul 8, 2024
98772b7
Improve wording
thobson88 Jul 8, 2024
0036eaa
Don't copy the command prompt character
thobson88 Jul 9, 2024
8f96183
Add Documentation section in dev guide
thobson88 Jul 9, 2024
5807c00
Add instructions on using the Terminal
thobson88 Jul 9, 2024
361c8ad
Change headings in User Roles section
thobson88 Jul 9, 2024
fe64e02
Add notes on environment variables
thobson88 Jul 9, 2024
6396fa2
Add Trustchain configuration instructions
thobson88 Jul 9, 2024
93d940a
Add command to open file for editing
thobson88 Jul 9, 2024
e31eed4
Namecheck Turing Inst in Acknowledgements
thobson88 Jul 9, 2024
2ce4c7d
Fix typo
thobson88 Jul 9, 2024
4111246
Add table summary for Roles vs software
thobson88 Jul 10, 2024
ae85e22
Add support for page-centred tables
thobson88 Jul 10, 2024
1a6b2bf
Add tips on batching DID operations
thobson88 Jul 10, 2024
2b41ce8
Improve wording of use cases
thobson88 Jul 10, 2024
6582158
Add console lang identifier in shell commands
thobson88 Jul 10, 2024
255aebc
Add ION installation instructions (draft)
thobson88 Jul 13, 2024
4c6f194
Add notes on local vs remote ION installation
thobson88 Jul 13, 2024
e6ae7d6
Add ION system requirements
thobson88 Jul 13, 2024
ab6af51
Add notes on ION env variables
thobson88 Jul 13, 2024
5c9d888
Add a config file check
thobson88 Jul 13, 2024
ee789bc
Add instructions for setting ION config
thobson88 Jul 13, 2024
57801fb
Tidy up ION install guide
thobson88 Jul 13, 2024
defb2d3
Add notes on Bitcoin RPC username/password
thobson88 Jul 14, 2024
ebf7d5e
Add not on creating Bitcoin wallet
thobson88 Jul 14, 2024
ca6e944
Add warning about ~ character in datadir param
thobson88 Jul 15, 2024
0359e2b
Update RPC credentials instructions
thobson88 Jul 15, 2024
4926d31
Add notes on funding your Bitcoin wallet
thobson88 Jul 15, 2024
8d4e193
Minor edit
thobson88 Jul 15, 2024
ee0d2de
Update troubleshooting tips & ION config notes
thobson88 Jul 16, 2024
d81d5e1
Add Bitcoin install guide for Linux
thobson88 Jul 16, 2024
6997ed2
Add commands to set user permissions on config files
thobson88 Jul 16, 2024
91d88d4
Replace Mac OS with macOS
thobson88 Jul 16, 2024
231dd92
Fix indentation for macOS-only steps
thobson88 Jul 16, 2024
1394ef7
Add WIF instructions for mainnet
thobson88 Jul 16, 2024
d4cbaf3
Fix indentation
thobson88 Jul 16, 2024
df4a99d
Add notes on troubleshooting & synchronisation time
thobson88 Jul 16, 2024
09b1227
Fix typos, minor tweaks
thobson88 Jul 16, 2024
1363f07
Add CI workflow for auto mkdocs deployment
thobson88 Jul 17, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
name: ci
on:
push:
branches:
- master
- main
permissions:
contents: write
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Configure Git Credentials
run: |
git config user.name github-actions[bot]
git config user.email 41898282+github-actions[bot]@users.noreply.github.com
- uses: actions/setup-python@v5
with:
python-version: 3.x
- run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV
- uses: actions/cache@v4
with:
key: mkdocs-material-${{ env.cache_id }}
path: .cache
restore-keys: |
mkdocs-material-
- run: pip install mkdocs-material
- run: mkdocs gh-deploy --force
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -31,3 +31,6 @@ outputs/

# dist paths
**/dist

# OS
.DS_Store
1 change: 1 addition & 0 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ repos:
rev: v2.3.0
hooks:
- id: check-yaml
args: [--unsafe]
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could exclude instead though I think this is the only yml in the repo so the --unsafe flag seems better

Suggested change
args: [--unsafe]
exclude: mkdocs\.yml

- id: end-of-file-fixer
- id: trailing-whitespace
- repo: https://github.com/doublify/pre-commit-rust
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
2 changes: 2 additions & 0 deletions docs-docsify/acknowledgements.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
# Acknowledgements
This work was supported, in whole or in part, by the Bill & Melinda Gates Foundation [INV-001309].
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# License & disclaimer
Trustchain is distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See [LICENSE-MIT](LICENSE-MIT) and [LICENSE-APACHE](LICENSE-APACHE) for details.
See [LICENSE-MIT](LICENSE-MIT) and [LICENSE-APACHE](LICENSE-APACHE) for details.
2 changes: 1 addition & 1 deletion docs/theme-custom.css → docs-docsify/theme-custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -27,4 +27,4 @@
--cover-heading-font-size-min : var(--font-size-s);
--cover-heading-font-size-max : var(--font-size-s);
--cover-heading-font-weight : bold;
}
}
File renamed without changes.
File renamed without changes
15 changes: 15 additions & 0 deletions docs/.pages
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
nav:
- index.md
- use-cases.md
- roles.md
- getting-started.md
- usage.md
# - deployment.md
- faq.md
# - glossary.md
- technical-notes.md
# - dev-guide.md
- ion.md
- contributing.md
- license.md
- acknowledgements.md
5 changes: 4 additions & 1 deletion docs/acknowledgements.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,5 @@
# Acknowledgements
This work was supported, in whole or in part, by the Bill & Melinda Gates Foundation [INV-001309].

Trustchain was developed at the Alan Turing Institute, the UK's national institute for data science and artificial intelligence.

This work was supported, in whole or in part, by the Bill & Melinda Gates Foundation [INV-001309].
Binary file added docs/assets/bitcoind-allow-anyway.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/bitcoind-macOS-pop-up.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/assets/figs/constrained_dDID.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/assets/figs/dDID_anatomy.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/trustchain-icon-circular-thick.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/trustchain-icon-circular.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/trustchain-icon.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 5 additions & 0 deletions docs/contributing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Contributing

Trustchain is free and open source software, and we welcome contributions from open source developers.

If you would like to contribute, please take a look at our [open issues](https://github.com/alan-turing-institute/trustchain/issues).
1 change: 1 addition & 0 deletions docs/deployment.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Deployment
Loading
Loading