retroweb:contribs-howto
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
retroweb:contribs-howto [2021-01-15 22:21] omolini [Questions Answered] |
retroweb:contribs-howto [2021-01-16 09:19] (current) omolini [Contribution Workflow] |
||
|---|---|---|---|
| Line 41: | Line 41: | ||
| - First open archive.org track down a good archived copy of a website domain. Browse the dates back and forth until you see a page with minimal amount of missing pictures, broken links or other errors. Note the date you've chosen. This date will be your target starting date for the archiver. | - First open archive.org track down a good archived copy of a website domain. Browse the dates back and forth until you see a page with minimal amount of missing pictures, broken links or other errors. Note the date you've chosen. This date will be your target starting date for the archiver. | ||
| - Open the Contributor Panel and select "Archive web site". Select a domain and target date as noted earlier. Select a link depth that is realistic for the website. If it's a large website, it could take days to complete with depth=6. If the website has an initial landing page or a "welcome" page with just one link to enter the main site, you may add +1 to the depth setting. | - Open the Contributor Panel and select "Archive web site". Select a domain and target date as noted earlier. Select a link depth that is realistic for the website. If it's a large website, it could take days to complete with depth=6. If the website has an initial landing page or a "welcome" page with just one link to enter the main site, you may add +1 to the depth setting. | ||
| - | - Once archiving is complete, you will see the page under Completed Jobs and a button that allows you to edit the site. Any changes can be previewed using the development proxy server. The proxy server works just like the production server, except you're able to browse your changes immediately, and throttling is disabled. The development server will also download pages from archive.org "on the fly", if a page does not exist while browsing the site you are trying to restore. This may be useful if you're validating all the links on a page and notice missing pages - automatic downloading ensures that you do not have to manually locate a file from archive.org. | + | - Once archiving is complete, you will see the page under Completed Jobs and next to your completed job you will see an "Edit" button. This button allows you to access the file manager so you can edit the website. Any changes you make can be previewed using the development proxy server. The proxy server works just like the production server, except you're able to browse your changes immediately, and throttling is disabled. The development server will also download pages from archive.org "on the fly", if a page does not exist while browsing the site you are trying to restore. This may be useful if you're validating all the links on a page and notice missing pages - automatic downloading ensures that you do not have to manually locate a file from archive.org. |
| - You will want to fix any broken links, and images. Once you're done, you can hit publish. The website will be marked published, and be viewable in the production server within 24 hours. | - You will want to fix any broken links, and images. Once you're done, you can hit publish. The website will be marked published, and be viewable in the production server within 24 hours. | ||
| - Also, if the archive job failed for whatever reason, feel free to delete it and start over. | - Also, if the archive job failed for whatever reason, feel free to delete it and start over. | ||
| ===== Questions Answered ===== | ===== Questions Answered ===== | ||
| + | **Q: How do I know if my job has completed or failed?**\\ | ||
| + | **A:** You can view running jobs in the Contributor Panel, and looking at the job logs of your project will usually indicate if a failure has occurred. If you notice the archival job is still running, but you have made an error, you can delete a running job and start over. | ||
| + | |||
| **Q: What if a recovered site is broken?**\\ | **Q: What if a recovered site is broken?**\\ | ||
| **A:** This depends. If the page is too far gone, and you cannot reconstruct the start page, we recommend you delete the site and find an alternative date with less broken links or images. If most of the pages are fine, you can fix some problems on a site manually, and missing graphics can be reconstructed. Sometimes you may find a file or a graphic that is missing but an alternative resource on archive.org or somewhere else on the net is available. In this case you can use the **Upload URL** feature in the **File Manager** which fetches a file from the Internet to the directory you specify. If portions of the website are not available anywhere, the links leading to broken areas of the websites may be commented out, so that the user is not presented with broken links. Do leave the HTML code in though, but comment it out. The hope is that eventually some broken areas can be restored with new restoration techniques. | **A:** This depends. If the page is too far gone, and you cannot reconstruct the start page, we recommend you delete the site and find an alternative date with less broken links or images. If most of the pages are fine, you can fix some problems on a site manually, and missing graphics can be reconstructed. Sometimes you may find a file or a graphic that is missing but an alternative resource on archive.org or somewhere else on the net is available. In this case you can use the **Upload URL** feature in the **File Manager** which fetches a file from the Internet to the directory you specify. If portions of the website are not available anywhere, the links leading to broken areas of the websites may be commented out, so that the user is not presented with broken links. Do leave the HTML code in though, but comment it out. The hope is that eventually some broken areas can be restored with new restoration techniques. | ||
| - | |||
| - | **Q: How do I know if my job has failed?**\\ | ||
| - | **A:** You can view running jobs in the Contributor Panel, and looking at the job logs of your project will usually indicate if a failure has occurred. If you notice the archival job is still running, but you have made an error, you can delete a running job and start over. | ||
| **Q: In the logs, it looks like archiving has slowed down. Is it stuck?**\\ | **Q: In the logs, it looks like archiving has slowed down. Is it stuck?**\\ | ||
| Line 64: | Line 64: | ||
| **A:** Yes, you can always back up your site, even after you fix and edit it. Just log on to the Contributor Panel, go to the File Manager of the your website using the Edit button, select all files, and click on the ZIP or TAR buttons to create archives of the selected files. You can then download the archive to your computer. | **A:** Yes, you can always back up your site, even after you fix and edit it. Just log on to the Contributor Panel, go to the File Manager of the your website using the Edit button, select all files, and click on the ZIP or TAR buttons to create archives of the selected files. You can then download the archive to your computer. | ||
| - | **Q: Can I capture specific URL's or files?**\\ | + | **Q: Can I capture specific URL's such as website subdirectories or specific files?**\\ |
| **A:** While this feature is planned to be added in the future, it is not currently available. If you need to add files to an existing site, you can upload them through the file manager, or use the Upload URL in the file manager to upload a link to a working file. If you need further assistance, contact one of the admins, and they will be able to modify the site files any way needed. | **A:** While this feature is planned to be added in the future, it is not currently available. If you need to add files to an existing site, you can upload them through the file manager, or use the Upload URL in the file manager to upload a link to a working file. If you need further assistance, contact one of the admins, and they will be able to modify the site files any way needed. | ||
| - | |||
| ---- | ---- | ||
retroweb/contribs-howto.1610749276.txt.gz · Last modified: 2021-01-15 22:21 by omolini
Page Tools
