mirrors/ArchiveBox
1
0
Fork 0
mirror of https://github.com/ArchiveBox/ArchiveBox.git synced 2025-05-15 15:44:26 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

update docs

Browse source
This commit is contained in:
Nick Sweeting 2017-10-30 04:08:11 -05:00
parent 5758cc2a78
commit 2b4384c311
1 changed files with 11 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

19
README.md
View file

@ -7,7 +7,7 @@ Save an archived copy of all websites you bookmark (the actual *content* of the
Outputs browsable static html archives of each site, a PDF, a screenshot, and a link to a copy on archive.org, all indexed in a nice html file. Outputs browsable static html archives of each site, a PDF, a screenshot, and a link to a copy on archive.org, all indexed in a nice html file.
(Your own personal Way-Back Machine) [DEMO: sweeting.me/pocket](https://home.sweeting.me/pocket) (Your own personal Way-Back Machine) [DEMO: sweeting.me/pocket](https://home.sweeting.me/pocket)
**Supports: Browser Bookmarks (Chrome, Firefox, Safari, IE, Opera), Pocket, Pinboard, Reddit, Wallabag, Shaarli, Delicious, Instapaper, Unmark.it, and more!** **Supports: Browser Bookmarks (Chrome, Firefox, Safari, IE, Opera), Pocket, Pinboard, Reddit, Wallabag, Shaarli, Delicious, Instapaper, Unmark.it, RSS, and more!**
![](screenshot.png) ![](screenshot.png)
@ -29,6 +29,7 @@ Follow the links here to find instructions for exporting bookmarks from each ser
- [Safari Bookmarks](http://i.imgur.com/AtcvUZA.png) - [Safari Bookmarks](http://i.imgur.com/AtcvUZA.png)
- [Opera Bookmarks](http://help.opera.com/Windows/12.10/en/importexport.html) - [Opera Bookmarks](http://help.opera.com/Windows/12.10/en/importexport.html)
- [Internet Explorer Bookmarks](https://support.microsoft.com/en-us/help/211089/how-to-import-and-export-the-internet-explorer-favorites-folder-to-a-32-bit-version-of-windows) - [Internet Explorer Bookmarks](https://support.microsoft.com/en-us/help/211089/how-to-import-and-export-the-internet-explorer-favorites-folder-to-a-32-bit-version-of-windows)
- RSS: pass the url as the second argument in the next step
(If any of these links are broken, please submit an issue and I'll fix it) (If any of these links are broken, please submit an issue and I'll fix it)
@ -133,17 +134,15 @@ The chrome/chromium dependency is _optional_ and only required for screenshots a
## Publishing Your Archive ## Publishing Your Archive
The archive produced by `./archive.py` is suitable for serving on any provider that The archive produced by `./archive.py` is suitable for serving on any provider that can host static html (e.g. github pages!).
can host static html (e.g. github pages!).
You can also serve it from a home server or VPS by uploading the archive folder You can also serve it from a home server or VPS by uploading the outputted `html` folder to your web directory, e.g. `/var/www/bookmark-archiver` and configuring your webserver.
to your web directory, e.g. `/var/www/pocket` and configuring your webserver.
Here's a sample nginx configuration that works to serve archive folders: Here's a sample nginx configuration that works to serve archive folders:
```nginx ```nginx
location /pocket/ { location / {
alias /var/www/pocket/; alias /var/www/bookmark-archiver/;
index index.html; index index.html;
autoindex on; # see directory listing upon clicking "The Files" links autoindex on; # see directory listing upon clicking "The Files" links
try_files $uri $uri/ =404; try_files $uri $uri/ =404;
@ -152,7 +151,7 @@ location /pocket/ {
Make sure you're not running any content as CGI or PHP, you only want to serve static files! Make sure you're not running any content as CGI or PHP, you only want to serve static files!
Urls look like: `https://sweeting.me/archive/archive/1493350273/en.wikipedia.org/wiki/Dining_philosophers_problem.html` Urls look like: `https://archive.example.com/archive/1493350273/en.wikipedia.org/wiki/Dining_philosophers_problem.html`
**Security WARNING & Content Disclaimer** **Security WARNING & Content Disclaimer**
@ -378,6 +377,10 @@ will run fast subsequent times because it only downloads new links that haven't
## Changelog ## Changelog
- v0.0.2 released
- support for chrome `--user-data-dir` to archive sites that need logins
- fancy individual html & json indexes for each link
- smartly append new links to existing index instead of overwriting
- proper HTML templating instead of format strings (thanks to https://github.com/bardisty!) - proper HTML templating instead of format strings (thanks to https://github.com/bardisty!)
- refactored into separate files, wip audio & video archiving - refactored into separate files, wip audio & video archiving
- v0.0.1 released - v0.0.1 released