-
Notifications
You must be signed in to change notification settings - Fork 5
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
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 60702ef
Add Material features
thobson88 2f317cd
Update colour palette & logo
thobson88 4a51f49
Increase logo size
thobson88 5b87840
Add navigation plugin and Use Cases page
thobson88 48591a4
Add favicon
thobson88 cc78906
Add technical notes, FAQs and placeholder pages
thobson88 6de6148
Add Roles and Usage pages
thobson88 a82765f
Add contributing notes & update useful links
thobson88 b19f6d1
Re-include search bar
thobson88 833a814
Fix FAQ page formatting
thobson88 9de277b
Add installation steps in Getting Started page
thobson88 c5ed394
Add Trustchain Mobile section on front page
thobson88 96b1d7c
Add text on Use Cases page
thobson88 c2d8302
Add Glossary page and (draft) ION installation notes
thobson88 0740710
Add (draft) Dev Guide notes
thobson88 18f715f
Remove quotes from root_event_time config param
thobson88 fa920f7
Undo last commit
thobson88 71c1b0d
Add CLI usage & configuration instructions
thobson88 b5460d0
Add whitespace at page bottoms
thobson88 0be3645
Hide deployment, glossary, dev-guide pages
thobson88 c74eccc
Fix link
thobson88 36b30b2
Update descriptions of four use cases
thobson88 41a31a2
Add link to BBC QR code scam video
thobson88 6a6cde5
Add more notes on the publish.sh script
thobson88 a0b6787
Minor text edits and fixes
thobson88 98772b7
Improve wording
thobson88 0036eaa
Don't copy the command prompt character
thobson88 8f96183
Add Documentation section in dev guide
thobson88 5807c00
Add instructions on using the Terminal
thobson88 361c8ad
Change headings in User Roles section
thobson88 fe64e02
Add notes on environment variables
thobson88 6396fa2
Add Trustchain configuration instructions
thobson88 93d940a
Add command to open file for editing
thobson88 e31eed4
Namecheck Turing Inst in Acknowledgements
thobson88 2ce4c7d
Fix typo
thobson88 4111246
Add table summary for Roles vs software
thobson88 ae85e22
Add support for page-centred tables
thobson88 1a6b2bf
Add tips on batching DID operations
thobson88 2b41ce8
Improve wording of use cases
thobson88 6582158
Add console lang identifier in shell commands
thobson88 255aebc
Add ION installation instructions (draft)
thobson88 4c6f194
Add notes on local vs remote ION installation
thobson88 e6ae7d6
Add ION system requirements
thobson88 ab6af51
Add notes on ION env variables
thobson88 5c9d888
Add a config file check
thobson88 ee789bc
Add instructions for setting ION config
thobson88 57801fb
Tidy up ION install guide
thobson88 defb2d3
Add notes on Bitcoin RPC username/password
thobson88 ebf7d5e
Add not on creating Bitcoin wallet
thobson88 ca6e944
Add warning about ~ character in datadir param
thobson88 0359e2b
Update RPC credentials instructions
thobson88 4926d31
Add notes on funding your Bitcoin wallet
thobson88 8d4e193
Minor edit
thobson88 ee0d2de
Update troubleshooting tips & ION config notes
thobson88 d81d5e1
Add Bitcoin install guide for Linux
thobson88 6997ed2
Add commands to set user permissions on config files
thobson88 91d88d4
Replace Mac OS with macOS
thobson88 231dd92
Fix indentation for macOS-only steps
thobson88 1394ef7
Add WIF instructions for mainnet
thobson88 d4cbaf3
Fix indentation
thobson88 df4a99d
Add notes on troubleshooting & synchronisation time
thobson88 09b1227
Fix typos, minor tweaks
thobson88 1363f07
Add CI workflow for auto mkdocs deployment
thobson88 File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -31,3 +31,6 @@ outputs/ | |
|
||
# dist paths | ||
**/dist | ||
|
||
# OS | ||
.DS_Store |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.
2 changes: 1 addition & 1 deletion
2
docs/license_disclaimer.md → docs-docsify/license_disclaimer.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
File renamed without changes
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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]. |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
# Deployment |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
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