update README files, set CI to ignore irrelevant paths
This commit is contained in:
parent
de492caaa5
commit
15dd82e300
8 changed files with 98 additions and 11 deletions
13
.github/workflows/build_gnu_linux.yml
vendored
13
.github/workflows/build_gnu_linux.yml
vendored
|
@ -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
|
||||||
|
|
13
.github/workflows/build_macos.yml
vendored
13
.github/workflows/build_macos.yml
vendored
|
@ -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
|
||||||
|
|
13
.github/workflows/build_windows.yml
vendored
13
.github/workflows/build_windows.yml
vendored
|
@ -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
|
||||||
|
|
11
.github/workflows/cd.yml
vendored
11
.github/workflows/cd.yml
vendored
|
@ -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
|
||||||
|
|
15
.github/workflows/ci.yml
vendored
15
.github/workflows/ci.yml
vendored
|
@ -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
|
||||||
|
|
23
README.md
23
README.md
|
@ -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
|
||||||
|
|
|
@ -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 |
|
||||||
|
|
Loading…
Reference in a new issue