From 10a5bcac98349aba5717d44cab22d50539136e61 Mon Sep 17 00:00:00 2001 From: Lucy Cifferello <12953208+elvece@users.noreply.github.com> Date: Sun, 13 Feb 2022 19:10:23 -0700 Subject: [PATCH] fix links and references so no compilation errors --- site/source/learn/concepts/embassy.rst | 2 +- site/source/learn/concepts/networks.rst | 4 ++-- .../build-package-example/references.rst | 18 ------------------ .../getting-started/environment-setup.rst | 8 ++++++-- .../service-packaging/specification/config.rst | 2 +- .../specification/dependencies.rst | 7 +++++++ .../service-packaging/specification/index.rst | 9 +++++---- .../specification/manifest.rst | 12 ++++++------ .../specification/overview.rst | 4 ++-- site/source/support/faq/faq-services.rst | 4 ++-- .../configuration/backup-setup/backup-mac.rst | 2 +- .../configuration/backup-setup/backup-win.rst | 2 +- .../tor-setup/tor-firefox/torff-windows.rst | 3 ++- .../tor-setup/tor-os/tor-android.rst | 2 +- site/source/support/user-manual/index.rst | 2 +- .../tuning/service-guides/bitcoin.rst | 8 ++++---- .../tuning/service-guides/lightning.rst | 2 +- 17 files changed, 43 insertions(+), 48 deletions(-) delete mode 100644 site/source/service-packaging/build-package-example/references.rst create mode 100644 site/source/service-packaging/specification/dependencies.rst diff --git a/site/source/learn/concepts/embassy.rst b/site/source/learn/concepts/embassy.rst index 230fe7a..f57309a 100644 --- a/site/source/learn/concepts/embassy.rst +++ b/site/source/learn/concepts/embassy.rst @@ -28,7 +28,7 @@ If you purchase a device from us, this is printed on the bottom of your Embassy. The first and foremost use of the Product Key is to encrypt data that is sent to Embassy at :ref:`Initial Setup`. There are several other usecases. Start9 keeps an anonymous database of all Product Keys that have been purchased by us (ZERO additional data is associated) so that we can verify someone is a "paid user." Currently this is just to allow someone to get a new copy of the EOS image if they have a problem, but in future we intend to give added bonuses to customers who have chosen to pay us for a copy of the software. -.. _services: +.. _services-eos: Services -------- diff --git a/site/source/learn/concepts/networks.rst b/site/source/learn/concepts/networks.rst index ce878ed..2577477 100644 --- a/site/source/learn/concepts/networks.rst +++ b/site/source/learn/concepts/networks.rst @@ -50,7 +50,7 @@ We decided to have the Embassy act as a Certificate Authority. It creates a self When you setup SSL for your Embassy and device, the certificate communicates to the client (a browser) that the server (the Embassy) demonstrated ownership of the domain (the ``embassy-xxxxxxxx.local`` address) to the certificate authority (created on the Embassy) at the time of certificate issuance (during the setup process). The Embassy dashboard can then be accessed from a home network (LAN) using a secure HTTPS connection! -For more information on how to setup your devices to enable this feature visit :ref:`ssl-setup`. +For more information on how to setup your devices to enable this feature visit :ref:`lan-setup`. .. _tor: @@ -81,4 +81,4 @@ Tor Hidden Service ------------------ A Tor Hidden Service is essentially just software or a website that is only broadcast on the Tor network. These are identified by a long, random public key, and end with the ``.onion`` suffix. For example, you can visit http://privacy34kn4ez3y3nijweec6w4g54i3g54sdv7r5mr6soma3w4begyd.onion to view the Start9 homepage on Tor. -In order to reach a Hidden Service, you must use a browser that can handle ``.onion`` domains, such as `The Tor Browser `_ or by configuring :ref:`Firefox <>` ***REF NEEDED***. +In order to reach a Hidden Service, you must use a browser that can handle ``.onion`` domains, such as `The Tor Browser `_ or by configuring :ref:`Firefox `. diff --git a/site/source/service-packaging/build-package-example/references.rst b/site/source/service-packaging/build-package-example/references.rst deleted file mode 100644 index f31668b..0000000 --- a/site/source/service-packaging/build-package-example/references.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. _packaging-references: - -==================== -Packaging References -==================== - -Below are links to working examples of more advanced configurations for current Embassy services. They might serve as a starting point or reference during your development process: - -TODO update links when merged to master - -- Detailed `docker_entrypoint.sh` - `Filebrowser `_ -- Optional dependencies - `BTCPay Server `_ -- Config spec - `BTCPay Server `_ -- Config rules - `BTC RPC Proxy `_ -- Multiple dependencies - `BTCPay Server `_ -- Actions - `BTCPay Server `_ -- Health checks - `BTCPay Server `_ -- Alerts - `BTCPay Server `_ diff --git a/site/source/service-packaging/getting-started/environment-setup.rst b/site/source/service-packaging/getting-started/environment-setup.rst index 3f70d58..dcbb9be 100644 --- a/site/source/service-packaging/getting-started/environment-setup.rst +++ b/site/source/service-packaging/getting-started/environment-setup.rst @@ -24,6 +24,8 @@ We recommend using the build in terminal as a command line interface (CLI) for y If you are new to the command line, Ionic has published this awesome `guide `_ to get you started. +.. _environment-setup-git: + Git === @@ -50,11 +52,12 @@ Cargo Cargo is the package management solution for the Rust programming language. It will install Rust to your system, and provide the required environment to build the Embassy SDK for packaging your service into the required format needed by EmbassyOS. -Installation instructions for Cargo can be found `here `_. +Installation instructions for Cargo can be found `here `__. To verify the installation, open a terminal window and run: .. code:: bash + cargo --version SDK @@ -84,10 +87,11 @@ While not strictly necessary, having a running instance of EmbassyOS is recommen You can acquire EmbassyOS by :ref:`purchasing ` or following the :ref:`DIY guide `. .. _quick-start: + Quick Start Environment Setup ============================= - `Docker `_ - `Docker buildx `_ -- `Cargo `_ +- `Cargo `__ - `EmbassyOS `_ - `Embassy SDK `_ \ No newline at end of file diff --git a/site/source/service-packaging/specification/config.rst b/site/source/service-packaging/specification/config.rst index affd9d0..fd3ea01 100644 --- a/site/source/service-packaging/specification/config.rst +++ b/site/source/service-packaging/specification/config.rst @@ -1,4 +1,4 @@ -.. _service-config: +.. _configuration: ============= Configuration diff --git a/site/source/service-packaging/specification/dependencies.rst b/site/source/service-packaging/specification/dependencies.rst new file mode 100644 index 0000000..6e5aa83 --- /dev/null +++ b/site/source/service-packaging/specification/dependencies.rst @@ -0,0 +1,7 @@ +.. _dependencies: + +============ +Dependencies +============ + +TODO \ No newline at end of file diff --git a/site/source/service-packaging/specification/index.rst b/site/source/service-packaging/specification/index.rst index 6e70f5f..9cdf71b 100644 --- a/site/source/service-packaging/specification/index.rst +++ b/site/source/service-packaging/specification/index.rst @@ -10,13 +10,14 @@ The following guides provide an in depth overview of the full capabilities avail :hidden: overview - wrapper + docker manifest emver - docker - makefile config properties - instructions + dependencies backups + instructions + wrapper + makefile submission diff --git a/site/source/service-packaging/specification/manifest.rst b/site/source/service-packaging/specification/manifest.rst index 1ed82f8..01fec5a 100644 --- a/site/source/service-packaging/specification/manifest.rst +++ b/site/source/service-packaging/specification/manifest.rst @@ -352,9 +352,9 @@ Types for ``manifest.yaml`` fields: TODO check accuracy Examples ======== -- `filebrowser <>`_ -- `embassy-pages <>`_ -- `photoview <>`_ -- `btcpayserver <>`_ -- `lnd <>`_ -- `synapse <>`_ +- `Hello World `__ +- `Filebrowser `__ +- `Embassy-pages `__ +- `Photoview `__ +- `BTCPay Server `__ +- `Synapse `__ diff --git a/site/source/service-packaging/specification/overview.rst b/site/source/service-packaging/specification/overview.rst index b0cbf15..bff7011 100644 --- a/site/source/service-packaging/specification/overview.rst +++ b/site/source/service-packaging/specification/overview.rst @@ -42,7 +42,7 @@ Image Each service boils down to a Docker image. We're not going to dive into Docker specifics in this guide, since there exists tons of `resources `_ for developing with this containerization tool. -Because the service ultimately runs on a Raspberry Pi, the created Docker image should be a snapshot of an arm based linux environment. The service image is then mounted to the EmbassyOS image during installation. This path is defined in the :ref:`manifest ` configuration file. +Because the service ultimately runs on a Raspberry Pi, the created Docker image should be a snapshot of an arm based linux environment. The service image is then mounted to the EmbassyOS image during installation. This path is defined in the :ref:`manifest ` configuration file. The image is immutable, meaning that when the service is updated, the image is replaced with a completely new image containing the updated features. @@ -98,7 +98,7 @@ The configuration and manifest files get bundled into the ``.s9pk`` package, whi Hello World Example =================== -For reference, the `Hello world `_ repository should be used as an example. A project template can be cloned using the "Use this template" button in GitHub. For a detailed walkthrough of this example, please see the :ref:`Packaging Example`. +For reference, the `Hello World `__ repository should be used as an example. A project template can be cloned using the "Use this template" button in GitHub. For a detailed walkthrough of this example, please see the :ref:`Packaging Example `. .. role:: raw-html(raw) diff --git a/site/source/support/faq/faq-services.rst b/site/source/support/faq/faq-services.rst index 8393871..de6c256 100644 --- a/site/source/support/faq/faq-services.rst +++ b/site/source/support/faq/faq-services.rst @@ -33,7 +33,7 @@ To get a general idea of what is required of an app, answer these questions: If all answers are yes, then it can run on EmbassyOS. -Packing up a service for the Embassy does not require extensive development skills. If you are interested in doing do, please see our :ref:`Developer Docs`. +Packing up a service for the Embassy does not require extensive development skills. If you are interested in doing do, please see our :ref:`Service Packaging Overview `. We are aggressively moving away from service development in favor of a more community driven approach. Meaning you, an app development team, or anyone else on Earth, can bring the Service they want to an Embassy Marketplace. You don't need our permission. @@ -96,4 +96,4 @@ By reading the descriptions in the link above, as well as doing some extra searc We translated much of (but not all of) the tons of options into a clean and easy-to-use GUI with toggles, dropdowns, inputs, etc, which is what you're seeing in your config screen. If you notice the little "?" icons on the left of each option, clicking them will provide a brief description as to what the option does. Also, our config GUI restricts the possible values you can enter such that you don't accidentally crash Bitcoin. That said, be very careful about just randomly changing things, lest your node starts to behave strangely. -You can also check out our :ref:`Service Config Spec ` documentation for further details. +You can also check out our :ref:`Service Config Spec ` documentation for further details. diff --git a/site/source/support/user-manual/configuration/backup-setup/backup-mac.rst b/site/source/support/user-manual/configuration/backup-setup/backup-mac.rst index a426e19..e8da408 100644 --- a/site/source/support/user-manual/configuration/backup-setup/backup-mac.rst +++ b/site/source/support/user-manual/configuration/backup-setup/backup-mac.rst @@ -27,4 +27,4 @@ Local Backups #. With Embassy powered down, plug in your external drive to the powered hub if you are using one, or directly into Embassy's available USB 3.0 (blue) slot if it is externally powered. #. Plug in power to your hub or drive #. Boot Embassy and go to ``Embassy`` -> ``Create Backup`` -#. + diff --git a/site/source/support/user-manual/configuration/backup-setup/backup-win.rst b/site/source/support/user-manual/configuration/backup-setup/backup-win.rst index 5e9cd39..0b51940 100644 --- a/site/source/support/user-manual/configuration/backup-setup/backup-win.rst +++ b/site/source/support/user-manual/configuration/backup-setup/backup-win.rst @@ -27,4 +27,4 @@ Local Backups #. With Embassy powered down, plug in your external drive to the powered hub if you are using one, or directly into Embassy's available USB 3.0 (blue) slot if it is externally powered. #. Plug in power to your hub or drive #. Boot Embassy and go to ``Embassy`` -> ``Create Backup`` -#. + diff --git a/site/source/support/user-manual/configuration/tor-setup/tor-firefox/torff-windows.rst b/site/source/support/user-manual/configuration/tor-setup/tor-firefox/torff-windows.rst index 792372b..03c5f28 100644 --- a/site/source/support/user-manual/configuration/tor-setup/tor-firefox/torff-windows.rst +++ b/site/source/support/user-manual/configuration/tor-setup/tor-firefox/torff-windows.rst @@ -49,4 +49,5 @@ Windows #. Click ``OK`` and then restart Firefox for the changes to take effect. -#. You're all set! You should now be able to navigate to ``.onion`` URLs in Firefox. This means you can access tor-only service :ref:`WebUIs `, such as Cups Messenger, and use your :ref:`Vaultwarden` Tor address in the `Bitwarden Firefox Plugin `_. You can test this by going to Start9's ``.onion`` homepage, `here `_. +#. You're all set! You should now be able to navigate to ``.onion`` URLs in Firefox. This means you can access tor-only service :ref:`WebUIs `, such as Cups Messenger, and use your :ref:`Vaultwarden` Tor address in the `Bitwarden Firefox Plugin `_. You can test this by going to Start9's ``.onion`` homepage, `here `__. + diff --git a/site/source/support/user-manual/configuration/tor-setup/tor-os/tor-android.rst b/site/source/support/user-manual/configuration/tor-setup/tor-os/tor-android.rst index 98bef38..52769a1 100644 --- a/site/source/support/user-manual/configuration/tor-setup/tor-os/tor-android.rst +++ b/site/source/support/user-manual/configuration/tor-setup/tor-os/tor-android.rst @@ -8,7 +8,7 @@ Some apps, such as :ref:`Tor Browser`, have Tor built in. They do n .. youtube:: b__mVfN-BP8 - Running Orbot +Running Orbot ------------- Orbot is a system wide proxy for your Android device that enables communications over Tor. diff --git a/site/source/support/user-manual/index.rst b/site/source/support/user-manual/index.rst index 87a0051..4eeca1d 100644 --- a/site/source/support/user-manual/index.rst +++ b/site/source/support/user-manual/index.rst @@ -22,7 +22,7 @@ User Manual EmbassyOS is designed to work out of the box with a minimal setup and immediate practicality. That said, there are many use-cases and utilities that can be added and tweaked at your convenience, which are covered extensively in this manual. You can get started right away with :ref:`Initial Setup `, head to our :doc:`Walkthrough ` for a guided tour, or learn about :doc:`Services ` and how to use them. In the :doc:`Configuration ` and :doc:`Tuning ` chapters, you can put your Embassy to work, and make it unique. Finally, you can cure common issues with :doc:`Troubleshooting ` or find answers in our :ref:`FAQ`. - For further information, check out our :ref:`Knowledge Base ` to learn about the technologies behind Embassy. If you want to build your own Embassy, check out the :ref:`DIY Guide`. When you're ready to build, please check out our :ref:`Developer Docs `. Please don't hestitate to :ref:`Contact Us ` if you have any issues, questions, or suggestions. + For further information, check out our :ref:`Knowledge Base ` to learn about the technologies behind Embassy. If you want to build your own Embassy, check out the :ref:`DIY Guide`. When you're ready to build, please check out our :ref:`Service Packaging Overview `. Please don't hestitate to :ref:`Contact Us ` if you have any issues, questions, or suggestions. * :doc:`Getting Started ` - Initial setup and device-specific guides to connect with your Embassy. * :doc:`Walkthrough ` - A guided tour of EmbassyOS. diff --git a/site/source/support/user-manual/tuning/service-guides/bitcoin.rst b/site/source/support/user-manual/tuning/service-guides/bitcoin.rst index 78cfed0..fe4d29c 100644 --- a/site/source/support/user-manual/tuning/service-guides/bitcoin.rst +++ b/site/source/support/user-manual/tuning/service-guides/bitcoin.rst @@ -1,4 +1,4 @@ -.. _bitcoin: +.. _bitcoin-service: ======= Bitcoin @@ -73,7 +73,7 @@ Available For Instructions ............ -Follow the `guide `_. +Follow the `guide `__. .. _specter: @@ -88,7 +88,7 @@ Available For Instructions ............ -Follow the `guide `_. +Follow the `guide `__. .. _trezor-suite: @@ -115,7 +115,7 @@ Instructions for accessing the bitcoind service in order to issue commands direc .. tip:: For example ``sudo docker exec bitcoind bitcoin-cli getnetworkinfo`` -A list of possible commands can be found `here `_. +A list of possible commands can be found `here `__. You can also drop into a shell using:: diff --git a/site/source/support/user-manual/tuning/service-guides/lightning.rst b/site/source/support/user-manual/tuning/service-guides/lightning.rst index d4c019d..d38dd21 100644 --- a/site/source/support/user-manual/tuning/service-guides/lightning.rst +++ b/site/source/support/user-manual/tuning/service-guides/lightning.rst @@ -8,7 +8,7 @@ Check out our `Getting Started with Lightning video