From df28ea525d6f892383a7ff38476faccf11200a5a Mon Sep 17 00:00:00 2001 From: Giga Bob <62410139+Bobinstein@users.noreply.github.com> Date: Sun, 1 Oct 2023 16:17:07 -0400 Subject: [PATCH] chore: merge into production (#14) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * chore: merge production into staging (#7) * chore: merge staging into production (#6) * mdBook * readme wip * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * demo * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * readme.md updated from https://stackedit.io/ * Building navigation * Added arfs 0.11 and 0.12 * completed proposal * init * feat: :art: updated for light/dark, other configs updated the app with the code for light/dark modes, made some other configuration changes. * style: :art: css changes stylized prev/next, added borders, color changes, other changes from whitepaper docs * fix: :bug: build script fix fixed depreciated build script * Update deploy.yml * set vuepress dist folder correctly * add base back * style: :art: fixed subheader color subheader color now matches general text color * refactor: removed about section about section existed as a workaround for sidebar defaulting to open, replaced it with price calclulator * docs: :memo: updated landing page replaced placeholder home page with content from ardrive.io * refactor: :memo: added new default page to /cli/, bug fixes replaced readme.md as the landing page for /cli/, fixed error with variable not being initialized. * docs: :memo: added arfs overview overview landing page for arfs * fix: :bug: fixed metadata fixed project metadata so it no longer shows whitepaper * fix: :art: fix logo on light mode logo was not displaying on light mode, cannot recreate locally. pushing possible fix * fix: :bug: log fix another attempt to fix the logo bug * fix: :bug: logo fix defaulted to uncustomized logo src because switching is not needed * fix: :bug: logo fix lets try this fix * style: :art: search box styling basic search box and result styling for readability, will need further input * docs: :memo: inline code styling, added docs created css to target inline code only, will need to be adjusted to team preference. Added some ArFS documentation * docs: :memo: ArFS docs more ArFS documentation. * docs: :memo: ArFS docs additional docs for ArFS * docs: :memo: ArFS Docs ArFS docs, based on confluence post from Phil, have been added up to Operations * refactor: title change changed title from ardrive.io to ArDrive Docs * h2 border-bottom * h2 line styling * added Snapshot entity information * style: :art: style changes several style changes, added customized search box component, replaced discord text with logo, still need to even out SVGs * fixed search result colors * added magnifying glass to search bar for visual * SearchBox styling changes * style changes * docs: :art: added more ArFS docs, styling changes added usage docs, set up sidebar - no custom sidebar yet, styling changes - need to identify issue with sidebar subheader coloring * turned 'last updated' off * style: :art: style changes several style changes suggested by Jonathan * style: :art: changed sidebar order moved core sdk up in sidebar because if the first item has a dropdown it will always start open * style: :art: style changes several style changes suggested by jacob * fix: :bug: fixed links link references were broken when cli file was split. corrected * style: :art: prev / next styling styled the prev and next buttons * style: :art: fixed sidebar item color found and removed rule givinig some sidebar items an opacity * style: :art: minor style changes minor style changes * docs: :art: added overview tag all sections except price calculator now begin with the overview header * sidebar change * style: :art: adjusted nav icons * change prev/next button background color in dark mode * added CNAME file * changed base path * fixed logo path * capitalize page description * added plausible script * Made ArDrive logo larger * Updated data-model.md * added Overview to price Calculator * added meta image * changed support link * spaced nav icons * merge from staging * merge conflicts resolved * completely functional, needs styling * style: :art: set basic styling for the seach modal * updated modal styling * updated ArFS Overview * Added copy button to code blocks using 'vuepress-plugin\-code-copy' plugin * docs: :memo: Updated ArFS documentation Updated ArFS documentation to match recent atlassian updates. * docs: added deployment docs added docs explaining how to deploy a dApp using the ArDrive web app. * docs: added deploy docs added docs for deploying dApps using the ArDrive web app * fix: fixed bug preventing build syntax for removing prev/next buttons on certain pages was incorrect and prevented build. commented out. * refactor: Corrected syntax to remove prev/next corrected the syntax commented out in the previous commit. Unneeded prev/next buttons removed without affecting build * docs: Added Examples page Added page with example websites for deploying a dApp to Arweave * docs: Added Turbo API docs Added preliminary docs for the Turbo Payment and Upload APIs * docs: typo correction replaced AR with data when referring to amount of data that can be uploaded * docs: Added openapi docs links Added disclaimer about docs being up to date, and linked to openapi docs which are maintained as changes are made. * chore: created package-lock.json file created package-lock.json so users can install dependencies with npm without issue. * fix: Fixed Zendesk link * docs(turbo): update CLI and Core docs with Turbo release PE-4435 (#4) --------- Co-authored-by: agsuy Co-authored-by: agsuy <37564412+agsuy@users.noreply.github.com> Co-authored-by: Phil Co-authored-by: Karl Prieb Co-authored-by: Derek Sonnenberg * feat(markdown files): adds documentation for Pins; applies minor clarifications PE-4497 (#5) Co-authored-by: Giga Bob <62410139+Bobinstein@users.noreply.github.com> --------- Co-authored-by: agsuy Co-authored-by: agsuy <37564412+agsuy@users.noreply.github.com> Co-authored-by: Phil Co-authored-by: Karl Prieb Co-authored-by: Derek Sonnenberg Co-authored-by: Matías Batista * chore: changed deploy to production instead of staging * fix: fixed visual bug in navbar * docs: Added Turbo-SDK doc * chore: update example in turbo sdk readme (#10) * chore: update examples * chore: fix links * docs: Added permasite page * docs: Permasite docs update --------- Co-authored-by: agsuy Co-authored-by: agsuy <37564412+agsuy@users.noreply.github.com> Co-authored-by: Phil Co-authored-by: Karl Prieb Co-authored-by: Derek Sonnenberg Co-authored-by: Matías Batista Co-authored-by: Dylan Fiedler --- docs/src/docs/misc/permasite.md | 58 ++++++++++++++++++++------------- 1 file changed, 36 insertions(+), 22 deletions(-) diff --git a/docs/src/docs/misc/permasite.md b/docs/src/docs/misc/permasite.md index 4517813..278ee0d 100644 --- a/docs/src/docs/misc/permasite.md +++ b/docs/src/docs/misc/permasite.md @@ -10,25 +10,37 @@ The process to make a ‘permasite’ takes 10 steps which are outlined below. ## 1. Download Static Site Files -ArDrive preserves static copies of existing websites. It will not enable backend interaction with your website’s CMS, allow you to make further changes to the content of your site, or support functionality like contact forms and eCommerce. But it will preserve full working copies of the static content of existing websites. +ArDrive allows you to preserve full working copies of the static content of existing websites but there are a few limitations to be aware of: +- Permanent sites will not enable backend interaction with your website’s CMS, +- nor allow you to make further changes to the content of your site, +- nor support dynamic functionality like contact forms and eCommerce. -To generate your static site files, we recommend [Offline Pages Pro](https://apps.apple.com/us/app/offline-pages-pro/id391462107) (Mac users only), which creates files that work well with this process. After saving your site with Offline Pages Pro, go to File > Export > Local Website to download the local static files. +To generate your static site files, we recommend: -Alternatively, the plugin [Simply Static](https://wordpress.org/plugins/simply-static/) generates static files for WordPress websites. Simply Static can fail to properly associate CSS and JS files with your static site, but some users have had success with this free WordPress plugin. +*Windows Users* +[WebCopy](https://www.cyotek.com/cyotek-webcopy) and [HtTrack](https://www.httrack.com/) enable Windows users to download static copies of entire websites. -Other tools, like [Wget](https://www.gnu.org/software/wget/), help capture static versions of websites. While Wget isn't a traditional static site generator, it's great for downloading whole websites for offline use. It offers a simple way to save your site's current look and feel as static files at no cost. +*Mac Users* +[Offline Pages Pro](https://apps.apple.com/us/app/offline-pages-pro/id391462107) (Mac users only), which creates files that work well with this process. After saving your site with Offline Pages Pro, go to File > Export > Local Website to download the local static files. +[SiteSucker](https://ricks-apps.com/osx/sitesucker/index.html) is another option for Mac users. + +*Command Line Utility* +[Wget](https://www.gnu.org/software/wget/) is a free tool that helps capture static versions of websites. While Wget isn't a traditional static site generator, it's great for downloading whole websites for offline use. It offers a simple way to save your site's current look and feel as static files at no cost. + +*WordPress* +[Simply Static]((https://wordpress.org/plugins/simply-static/)) is a plugin that generates static files for WordPress websites. Some users note that Simply Static fails to properly associate CSS and JS files with your static site, but others have had success with this free WordPress plugin. ## 2. Create an Account on ArDrive -Account creation is free as are uploads of files up to 500 KB. Remember that ArDrive has self-sovereign data; no corporation has your password. Make sure you don’t lose your password, keyfile and seed phrase - they can’t be recovered later. +Account creation is free as are uploads of small files (currently up to 500 KB). Remember that ArDrive empowers you to be in control of your data; no one else has your password but you. Therefore, it is very important that you safely record your password and seed phrase as they cannot be recovered later. ## 3. Create a New Public Drive -Click on the red +New button and create a Drive. Name your Drive and set it as “Public”. Currently, permanent websites can only be stored publicly. +Click on the red +New button and create a Drive. Name your Drive and set it as “Public”. ArDrive also offers “Private” file storage; however, permanent websites must be public in order to maintain functionality. ## 4. Top Up -Buy ArDrive Turbo credits with a credit card (or ensure your wallet has AR, the native token of the Arweave ecosystem). This will enable you to purchase storage on the Arweave blockchain. Most websites will cost less than $1 to save permanently. [See current prices](https://ardrive.io/pricing/) +To pay for permanent storage on the Arweave network you must either purchase ArDrive Turbo credits with a credit card or (or the advanced option) ensure your wallet has $AR, the native token of the Arweave ecosystem. Most websites will cost less than $1 to save permanently. [See current prices](https://ardrive.io/pricing/) ## 5. Upload Static Files @@ -36,15 +48,16 @@ Upload the static files to your new Public Drive. Offline Pages Pro will generat ## 6. Wait -Permanence takes patience. Once static files have been uploaded, they need to be sent to the Arweave network before being assembled together. This process can take as little as 5 seconds (when using Turbo credits) or up to 30 minutes or more (when using AR at a time of high network use). Make sure to keep your browser tab open and don’t refresh your browser while you wait. +Permanence takes patience. Once static files have been uploaded, they need to be sent to the Arweave network before being assembled together. This process can take as little as 5 seconds (when using Turbo credits) or up to 30 minutes or more (when using $AR). Make sure to keep your browser tab open and do not refresh your browser while you wait. -Instead, hit the refresh icon in the top right of ArDrive to check on the status of your files. You’ll know your file is ready when the light on the icon turns from yellow to green. (Pro Tip: some files uploaded with Turbo are ready before they are green.) +To check on the status of your files, you can click the refresh icon in the top right of ArDrive. You’ll know your file is ready when the light on the icon turns from yellow to green. (Pro Tip: some files uploaded with Turbo are ready before they are green.) ## 7. Create a Manifest -Manifests are special `.json` files that instruct Arweave Gateways to map file data associated with specific, unique transaction IDs to customized, hosted paths relative to that of the manifest file itself.” In other words, they are the secret sauce that brings a permasite together. +[Manifests](https://ardrive.io/manifests/) are special `.json` files that instruct Arweave Gateways to map file data associated with specific, unique transaction IDs to customized, hosted paths relative to that of the manifest file itself. In other words, they are the secret sauce that brings a permasite together. + +Click on the red +New button and select Advanced > New Manifest. Select the location for your manifest, ensuring it is in the same place as your index.html file. -Click on the red +New button and select Advanced > New Manifest. Select the location for your manifest, ensuring it is in the same placeas your index.html file. Give your Manifest a name like “permasite”, it will be the main way you access your permanent website from ArDrive. @@ -52,15 +65,15 @@ Give your Manifest a name like “permasite”, it will be the main way you acce Now the manifest needs to be sent to the Arweave network. Again, this process can take just a few seconds or up to 30 minutes or more. -After a while, refresh your Drive by clicking on the icon in the upper right – and see if your manifest icon turns from yellow to green. +After a bit, you can refresh your Drive by clicking on the icon in the upper right – and see if your manifest icon turns from yellow to green. ## 9. Preview the Manifest -Got a green light? You’re ready to go. Click on your manifest file and you’ll see a panel of options appear on the right side of your screen. Click on the Preview icon in the top right and it will open a new tab with your permasite. +Got a green light? You’re ready to go. Click on your manifest file and you will see a panel of options appear on the right side of your screen. Click on the Preview icon in the top right and it will open a new tab with your permasite. -If a website appears with a long, random-looking URL in the browser bar, you have a permasite. +If a website appears with a long, random-looking URL in the browser bar, then congrats, you made a permasite! -Try clicking around and make sure all your pages are preserved. If they aren’t it could be a limitation of your static site generator or an issue with the manifest (see Notes below). +Try clicking around and make sure all your pages are preserved. If they are not it could be a limitation of your static site generator or an issue with the manifest (see Notes below). ## 10. Add a Redirect or Domain Masking @@ -70,16 +83,17 @@ Try redirecting another domain to your permasite, or mask your permasite domain ## Notes - • There’s no delete button with Arweave. Once your permasite is up, it’s up forever. Make sure your content is something you want future humanity to have. +- There’s no delete button with Arweave. Once your permasite is up, it’s up forever. Make sure your content is something you want future humanity to have. + +- Only static sites can become permasites through the ArDrive web app. Advanced functionality is available for developers who use the [ArDrive CLI](https://app.ardrive.io). - • Only static sites can become permasites through the ArDrive web app. Advanced functionality is available for developers who use the [ArDrive CLI](https://app.ardrive.io). +- Links to content on external websites will not be permanent (unless they are also permasites) and if that external content becomes inaccessible or moves, you will not be able to update the links within your permasite. - • Links to content on external websites will not be permanent (unless they are also permasites) and if that external content becomes inaccessible or moves, you will not be able to update the links within your permasite. +- Non-English characters in the URLs of your permasite can be problematic for ArDrive manifests, but non-English characters should work well on the permasite itself. - • Non-English characters in the URLs of your permasite can be problematic for ArDrive manifests, but non-English characters should work well on the permasite itself. +## Other Use Cases -## Applications +Permasites can be used to archive web content before it disappears from the internet. Or they can be used to create working copies of websites before it a particular site is replaced by new versions. -Permasites can be used to archive web content before it disappears from the internet. Or they can be used to create working copies of websites before it a particular site is replaced by a new version. +Manifests can also be used to make reliable perma-backups. Many web hosts offer good daily backups and some offer reliable offsite backups as well. Permasites enable you to have decentralized, highly-redundant backups of your website’s content for a very low cost. -Manifests can also be used to make reliable perma-backups. Many web hosts offer good daily backups and some offer reliable offsite backups as well. Permasites enable you to have decentralized, highly-redundant backups of your website’s content for a very low cost. \ No newline at end of file