wrolpi-help/docs/modules/archives/files.md

38 lines
No EOL
1.6 KiB
Markdown

# Archive Files
WROLPi creates several files when archiving a webpage:
1. A [Singlefile](index.md#singlefile) that stores an exact copy of the web page.
2. A [Readability](index.md#readability) file.
3. A Readability text file.
4. A Readability JSON file.
5. A screenshot file of the web page.
These files all share the same filename but have different suffixes.
| File Suffix | Purpose |
|-------------------|--------------------------------------------|
| .html | The Singlefile. |
| .readability.html | The Readability extract of the Singlefile. |
| .readability.txt | The article text extracted by Readability. |
| .readability.json | Data from Readability (URL/author/etc.). |
| .png | The screenshot of the web page. |
Archive files are named using three parts:
1. The domain directory.
2. The archive date time (YYYY-MM-DD-HH-MM-SS).
3. The title of the web page.
If archiving `https://wrolpi.org/getting-started`, the resulting files might be named as follows:
```
/media/wrolpi/archive/wrolpi.org/2023-01-01-12-00-00_Getting Started.html
/media/wrolpi/archive/wrolpi.org/2023-01-01-12-00-00_Getting Started.readability.html
/media/wrolpi/archive/wrolpi.org/2023-01-01-12-00-00_Getting Started.readability.txt
/media/wrolpi/archive/wrolpi.org/2023-01-01-12-00-00_Getting Started.readability.json
/media/wrolpi/archive/wrolpi.org/2023-01-01-12-00-00_Getting Started.png
```
WROLPi will attempt to extract the Readability and create a screenshot from the Singlefile. If this is not possible,
WROLPi will still keep the lone Singlefile.