update README files, set CI to ignore irrelevant paths

This commit is contained in:
Sunshine 2021-10-20 15:31:54 -10:00
parent de492caaa5
commit 15dd82e300
No known key found for this signature in database
GPG key ID: B80CA68703CD8AB1
8 changed files with 98 additions and 11 deletions

View file

@ -3,6 +3,17 @@ name: GNU/Linux
on: on:
push: push:
branches: [ master ] branches: [ master ]
paths-ignore:
- 'assets/'
- 'dist/'
- 'docs/'
- 'snap/'
- '.adr-dir'
- 'Dockerfile'
- 'LICENSE'
- 'Makefile'
- 'monolith.nuspec'
- 'README.md'
jobs: jobs:
build: build:
@ -17,6 +28,8 @@ jobs:
steps: steps:
- run: git config --global core.autocrlf false - run: git config --global core.autocrlf false
- uses: actions/checkout@v2 - uses: actions/checkout@v2
- name: Build - name: Build
run: cargo build --all --locked --verbose run: cargo build --all --locked --verbose

View file

@ -3,6 +3,17 @@ name: macOS
on: on:
push: push:
branches: [ master ] branches: [ master ]
paths-ignore:
- 'assets/'
- 'dist/'
- 'docs/'
- 'snap/'
- '.adr-dir'
- 'Dockerfile'
- 'LICENSE'
- 'Makefile'
- 'monolith.nuspec'
- 'README.md'
jobs: jobs:
build: build:
@ -17,6 +28,8 @@ jobs:
steps: steps:
- run: git config --global core.autocrlf false - run: git config --global core.autocrlf false
- uses: actions/checkout@v2 - uses: actions/checkout@v2
- name: Build - name: Build
run: cargo build --all --locked --verbose run: cargo build --all --locked --verbose

View file

@ -3,6 +3,17 @@ name: Windows
on: on:
push: push:
branches: [ master ] branches: [ master ]
paths-ignore:
- 'assets/'
- 'dist/'
- 'docs/'
- 'snap/'
- '.adr-dir'
- 'Dockerfile'
- 'LICENSE'
- 'Makefile'
- 'monolith.nuspec'
- 'README.md'
jobs: jobs:
build: build:
@ -17,6 +28,8 @@ jobs:
steps: steps:
- run: git config --global core.autocrlf false - run: git config --global core.autocrlf false
- uses: actions/checkout@v2 - uses: actions/checkout@v2
- name: Build - name: Build
run: cargo build --all --locked --verbose run: cargo build --all --locked --verbose

View file

@ -13,10 +13,13 @@ jobs:
runs-on: windows-2019 runs-on: windows-2019
steps: steps:
- run: git config --global core.autocrlf false - run: git config --global core.autocrlf false
- name: Checkout the repository - name: Checkout the repository
uses: actions/checkout@v2 uses: actions/checkout@v2
- name: Build the executable - name: Build the executable
run: cargo build --release run: cargo build --release
- uses: Shopify/upload-to-release@1.0.0 - uses: Shopify/upload-to-release@1.0.0
with: with:
name: monolith.exe name: monolith.exe
@ -28,6 +31,7 @@ jobs:
steps: steps:
- name: Checkout the repository - name: Checkout the repository
uses: actions/checkout@v2 uses: actions/checkout@v2
- name: Prepare cross-platform environment - name: Prepare cross-platform environment
run: | run: |
sudo mkdir /cross-build sudo mkdir /cross-build
@ -44,8 +48,10 @@ jobs:
echo "OPENSSL_LIB_DIR=/cross-build/usr/lib/arm-linux-gnueabihf" >> $GITHUB_ENV echo "OPENSSL_LIB_DIR=/cross-build/usr/lib/arm-linux-gnueabihf" >> $GITHUB_ENV
echo "PKG_CONFIG_ALLOW_CROSS=1" >> $GITHUB_ENV echo "PKG_CONFIG_ALLOW_CROSS=1" >> $GITHUB_ENV
echo "RUSTFLAGS=-C linker=arm-linux-gnueabihf-gcc -L/usr/arm-linux-gnueabihf/lib -L/cross-build/usr/lib/arm-linux-gnueabihf -L/cross-build/lib/arm-linux-gnueabihf" >> $GITHUB_ENV echo "RUSTFLAGS=-C linker=arm-linux-gnueabihf-gcc -L/usr/arm-linux-gnueabihf/lib -L/cross-build/usr/lib/arm-linux-gnueabihf -L/cross-build/lib/arm-linux-gnueabihf" >> $GITHUB_ENV
- name: Build the executable - name: Build the executable
run: cargo build --release --target=arm-unknown-linux-gnueabihf run: cargo build --release --target=arm-unknown-linux-gnueabihf
- name: Attach artifact to the release - name: Attach artifact to the release
uses: Shopify/upload-to-release@1.0.0 uses: Shopify/upload-to-release@1.0.0
with: with:
@ -58,6 +64,7 @@ jobs:
steps: steps:
- name: Checkout the repository - name: Checkout the repository
uses: actions/checkout@v2 uses: actions/checkout@v2
- name: Prepare cross-platform environment - name: Prepare cross-platform environment
run: | run: |
sudo mkdir /cross-build sudo mkdir /cross-build
@ -74,8 +81,10 @@ jobs:
echo "OPENSSL_LIB_DIR=/cross-build/usr/lib/aarch64-linux-gnu" >> $GITHUB_ENV echo "OPENSSL_LIB_DIR=/cross-build/usr/lib/aarch64-linux-gnu" >> $GITHUB_ENV
echo "PKG_CONFIG_ALLOW_CROSS=1" >> $GITHUB_ENV echo "PKG_CONFIG_ALLOW_CROSS=1" >> $GITHUB_ENV
echo "RUSTFLAGS=-C linker=aarch64-linux-gnu-gcc -L/usr/aarch64-linux-gnu/lib -L/cross-build/usr/lib/aarch64-linux-gnu" >> $GITHUB_ENV echo "RUSTFLAGS=-C linker=aarch64-linux-gnu-gcc -L/usr/aarch64-linux-gnu/lib -L/cross-build/usr/lib/aarch64-linux-gnu" >> $GITHUB_ENV
- name: Build the executable - name: Build the executable
run: cargo build --release --target=aarch64-unknown-linux-gnu run: cargo build --release --target=aarch64-unknown-linux-gnu
- name: Attach artifact to the release - name: Attach artifact to the release
uses: Shopify/upload-to-release@1.0.0 uses: Shopify/upload-to-release@1.0.0
with: with:
@ -88,8 +97,10 @@ jobs:
steps: steps:
- name: Checkout the repository - name: Checkout the repository
uses: actions/checkout@v2 uses: actions/checkout@v2
- name: Build the executable - name: Build the executable
run: cargo build --release run: cargo build --release
- uses: Shopify/upload-to-release@1.0.0 - uses: Shopify/upload-to-release@1.0.0
with: with:
name: monolith-gnu-linux-x86_64 name: monolith-gnu-linux-x86_64

View file

@ -5,6 +5,17 @@ name: CI
on: on:
pull_request: pull_request:
branches: [ master ] branches: [ master ]
paths-ignore:
- 'assets/'
- 'dist/'
- 'docs/'
- 'snap/'
- '.adr-dir'
- 'Dockerfile'
- 'LICENSE'
- 'Makefile'
- 'monolith.nuspec'
- 'README.md'
jobs: jobs:
build_and_test: build_and_test:
@ -23,11 +34,15 @@ jobs:
steps: steps:
- run: git config --global core.autocrlf false - run: git config --global core.autocrlf false
- uses: actions/checkout@v2 - uses: actions/checkout@v2
- name: Build - name: Build
run: cargo build --all --locked --verbose run: cargo build --all --locked --verbose
- name: Run tests - name: Run tests
run: cargo test --all --locked --verbose run: cargo test --all --locked --verbose
- name: Check code formatting - name: Check code formatting
run: | run: |
rustup component add rustfmt rustup component add rustfmt

View file

@ -25,54 +25,60 @@ If compared to saving websites with `wget -mpk`, this tool embeds all assets as
## Installation ## Installation
#### Using [Cargo](https://crates.io/crates/monolith) #### Using [Cargo](https://crates.io/crates/monolith)
```console ```console
cargo install monolith cargo install monolith
``` ```
#### Via [Homebrew](https://formulae.brew.sh/formula/monolith) (macOS and GNU/Linux) #### Via [Homebrew](https://formulae.brew.sh/formula/monolith) (macOS and GNU/Linux)
```console ```console
brew install monolith brew install monolith
``` ```
#### Via [MacPorts](https://ports.macports.org/port/monolith/summary) (macOS) #### Via [MacPorts](https://ports.macports.org/port/monolith/summary) (macOS)
```console ```console
sudo port install monolith sudo port install monolith
``` ```
#### Via [MacPorts](https://ports.macports.org/port/monolith/summary) (macOS) #### Via [MacPorts](https://ports.macports.org/port/monolith/summary) (macOS)
```console ```console
sudo port install monolith sudo port install monolith
``` ```
#### Using [Snapcraft](https://snapcraft.io/monolith) (GNU/Linux) #### Using [Snapcraft](https://snapcraft.io/monolith) (GNU/Linux)
```console ```console
snap install monolith snap install monolith
``` ```
#### Using [FreeBSD packages](https://svnweb.freebsd.org/ports/head/www/monolith/) (FreeBSD) #### Using [FreeBSD packages](https://svnweb.freebsd.org/ports/head/www/monolith/) (FreeBSD)
```console ```console
pkg install monolith pkg install monolith
``` ```
#### Using [FreeBSD ports](https://www.freshports.org/www/monolith/) (FreeBSD) #### Using [FreeBSD ports](https://www.freshports.org/www/monolith/) (FreeBSD)
```console ```console
cd /usr/ports/www/monolith/ cd /usr/ports/www/monolith/
make install clean make install clean
``` ```
#### Using [pkgsrc](https://pkgsrc.se/www/monolith) (NetBSD, OpenBSD, Haiku, etc) #### Using [pkgsrc](https://pkgsrc.se/www/monolith) (NetBSD, OpenBSD, Haiku, etc)
```console ```console
cd /usr/pkgsrc/www/monolith cd /usr/pkgsrc/www/monolith
make install clean make install clean
``` ```
#### Using [pre-built binaries](https://github.com/Y2Z/monolith/releases) (Windows, ARM-based devices, etc)
Every release contains pre-built binaries for Windows, GNU/Linux, as well as platforms with non-standart CPU architecture.
#### Using [containers](https://www.docker.com/) #### Using [containers](https://www.docker.com/)
```console ```console
docker build -t Y2Z/monolith . docker build -t Y2Z/monolith .
sudo install -b utils/run-in-container.sh /usr/local/bin/monolith sudo install -b dist/run-in-container.sh /usr/local/bin/monolith
``` ```
#### From source #### From source
@ -85,11 +91,16 @@ cd monolith
make install make install
``` ```
#### Using [pre-built binaries](https://github.com/Y2Z/monolith/releases) (Windows, ARM-based devices, etc)
Every release contains pre-built binaries for Windows, GNU/Linux, as well as platforms with non-standart CPU architecture.
--------------------------------------------------- ---------------------------------------------------
## Usage ## Usage
```console ```console
monolith https://lyrics.github.io/db/P/Portishead/Dummy/Roads/ -o portishead-roads-lyrics.html monolith https://lyrics.github.io/db/P/Portishead/Dummy/Roads/ -o portishead-roads-lyrics.html
``` ```
@ -103,6 +114,7 @@ cat index.html | monolith -aIiFfcMv -b https://original.site/ - > result.html
## Options ## Options
- `-a`: Exclude audio sources - `-a`: Exclude audio sources
- `-b`: Use custom `base URL` - `-b`: Use custom `base URL`
- `-c`: Exclude CSS - `-c`: Exclude CSS
@ -127,6 +139,7 @@ cat index.html | monolith -aIiFfcMv -b https://original.site/ - > result.html
## Proxies ## Proxies
Please set `https_proxy`, `http_proxy`, and `no_proxy` environment variables. Please set `https_proxy`, `http_proxy`, and `no_proxy` environment variables.
@ -134,6 +147,7 @@ Please set `https_proxy`, `http_proxy`, and `no_proxy` environment variables.
## Contributing ## Contributing
Please open an issue if something is wrong, that helps make this project better. Please open an issue if something is wrong, that helps make this project better.
@ -141,6 +155,7 @@ Please open an issue if something is wrong, that helps make this project better.
## Related projects ## Related projects
- Monolith Chrome Extension: https://github.com/rhysd/monolith-of-web - Monolith Chrome Extension: https://github.com/rhysd/monolith-of-web
- Pagesaver: https://github.com/distributed-mind/pagesaver - Pagesaver: https://github.com/distributed-mind/pagesaver
- Personal WayBack Machine: https://github.com/popey/pwbm - Personal WayBack Machine: https://github.com/popey/pwbm

View file

@ -1,10 +1,17 @@
# Web apps that can be saved with Monolith # Web apps that can be saved with Monolith
These apps retain most or all of their functionality when saved with Monolith These apps retain all or most of their functionality when saved with Monolith:
| Converse | https://conversejs.org | | Converse | https://conversejs.org |
|:--|:--| |:-----------------------|:--------------------------------------------------------------------|
| Description | An XMPP client built using web technologies | | Description | An XMPP client built using web technologies |
| Functionality retained | **full** | | Functionality retained | **full** |
| Command to use | `monolith https://conversejs.org/fullscreen.html > conversejs.html` | | Command to use | `monolith https://conversejs.org/fullscreen.html > conversejs.html` |
| Monolith version used | 2.2.7 | | Monolith version used | 2.2.7 |
| Markdown Tables generator | https://www.tablesgenerator.com |
|:--------------------------|:-----------------------------------------------------------------------------------------------|
| Description | Tool for creating tables in extended Markdown format |
| Functionality retained | **full** |
| Command to use | `monolith -I https://www.tablesgenerator.com/markdown_tables -o markdown-table-generator.html` |
| Monolith version used | 2.6.1 |