aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorShulhan <ms@kilabit.info>2025-06-01 14:31:12 +0700
committerShulhan <ms@kilabit.info>2025-06-01 14:32:06 +0700
commit19b2e2d1ac0fd8a88af6b0da3d00017e4ee31c06 (patch)
tree3648ad12458e21a11cea25e2bef0a9fcd5a4604c /README
parent43408bb5faae9d0458a3f0a9f97741ce3222eb97 (diff)
downloadjarink-19b2e2d1ac0fd8a88af6b0da3d00017e4ee31c06.tar.xz
all: go embed the README and use it on the CLI for help command
Diffstat (limited to 'README')
-rw-r--r--README81
1 files changed, 45 insertions, 36 deletions
diff --git a/README b/README
index ad20e53..a26722f 100644
--- a/README
+++ b/README
@@ -1,54 +1,63 @@
= Jarink
-Jarink is a program to help web administrator to maintains their website.
+Jarink is a program to help web administrator and developers to inspect
+and maintains their website.
== Synopsis
- jarink [OPTIONS] <COMMAND> <args...>
+ jarink [OPTIONS] <COMMAND> <args...>
Available commands,
- brokenlinks - scan the website for broken links (page and images).
+ brokenlinks - scan the website for broken links (page and images).
+ help - print the usage of the command.
== Usage
[OPTIONS] brokenlinks URL
- Start scanning for broken links on the web server pointed by URL.
- Invalid links will be scanned on anchor href attribute
- ("<a href=...>") or on the image src attribute ("<img src=...").
+ Start scanning for broken links on the web server pointed by URL.
+ Links will be scanned on anchor href attribute ("<a href=...>") or
+ on the image src attribute ("<img src=...").
- Once finished it will print the page and list of broken links inside
- that page in JSON format.
+ Once finished it will print the page and list of broken links in
+ JSON format to standard output.
- This command accept the following options,
+ This command accept the following options,
- -verbose : print the page that being scanned.
+ -verbose : print the page that being scanned to standard
+ error.
- Example,
+ Example,
- $ jarink scan https://kilabit.info
- {
- "https://kilabit.info/some/page": [
- {
- "Link": "https://kilabit.info/some/page/image.png",
- "Code": 404
- },
- {
- "Link": "https://external.com/link",
- "Error": "Internal server error",
- "Code": 500
- }
- ],
- "https://kilabit.info/another/page": [
- {
- "Link": "https://kilabit.info/another/page/image.png",
- "Code": 404
- },
- {
- "Link": "https://external.org/link",
- "Error": "Internal server error",
- "Code": 500
- }
- ]
- }
+ $ jarink brokenlinks https://kilabit.info
+ {
+ "https://kilabit.info/some/page": [
+ {
+ "Link": "https://kilabit.info/some/page/image.png",
+ "Code": 404
+ },
+ {
+ "Link": "https://external.com/link",
+ "Error": "Internal server error",
+ "Code": 500
+ }
+ ],
+ "https://kilabit.info/another/page": [
+ {
+ "Link": "https://kilabit.info/another/page/image.png",
+ "Code": 404
+ },
+ {
+ "Link": "https://external.org/link",
+ "Error": "Internal server error",
+ "Code": 500
+ }
+ ]
+ }
+
+== Notes
+
+jarink version 0.1.0.
+
+Source code - https://git.sr.ht/~shulhan/jarink