Skip to content

Commit 0382bac

Browse files
committed
- [#] update README
1 parent 330d283 commit 0382bac

File tree

2 files changed

+57
-6
lines changed

2 files changed

+57
-6
lines changed

README.e.md

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,11 @@ SingleSel2: cascadia -i /tmp/cascadia.xml -o -c 'input[name=Sex][value=F]'
1414

1515
## {{toc 5}}
1616

17+
## {{.Name}} - CSS selector CLI tool
18+
1719
The [Go Cascadia package](https://github.com/andybalholm/cascadia) implements CSS selectors for html. This is the command line tool, started as a thin wrapper around that package, but growing into a better tool to test CSS selectors without writing Go code:
1820

19-
# Usage
21+
## Usage
2022

2123
#### $ {{exec "cascadia" | color "sh"}}
2224

@@ -193,14 +195,35 @@ Collecting as HTML is no trouble either. Here is another example:
193195

194196
The [fifth page is here](http://www.shangxueedu.com/shuxue/ksdg/20170113_162_5.html), and [all pages are collected here](https://docs.google.com/document/d/1StFwP7kChHiGsL-hm3tnY29bsBRQWCU7xdhu2shsGcg/preview). Please check them out.
195197

196-
# More On CSS Selector
198+
## More On CSS Selector
197199

198200
I'm not an expert on CSS Selector at all, but the following resources are what I found most helpful to me.
199201

200202
- [CSS Selectors Cheat Sheet](http://butlerccwebdev.net/support/css-selectors-cheatsheet.html) I think It's very good, because it's usage oriented and very practical, i.e., it arranges the Selectors according to their purposes. If that's too dry for you, check out
201203
- [The 30 CSS Selectors You Must Memorize](http://code.tutsplus.com/tutorials/the-30-css-selectors-you-must-memorize--net-16048) It only lists those selectors that are important, but it gives concrete examples and explanations
202204
- [CSS Selector Reference](http://www.w3schools.com/cssref/css_selectors.asp) from w3schools. This is the one I most often refer to, because the list is comprehensive, and there is also an online [CSS Selector Tester](http://www.w3schools.com/cssref/trysel.asp) that really helped me learn and understand
203205

206+
## Download/Install
207+
208+
209+
### Download binaries
210+
211+
- The latest binary executables are available right under the github release page
212+
https://github.com/suntong/{{.Name}}/releases
213+
as the result of the Continuous-Integration process.
214+
- I.e., they are built during every git tagged push, automatically by [GitHub Actions](https://github.com/features/actions), right from the source code, truely WYSIWYG.
215+
- The `.deb`, `.rpm` and `.apk` packages are readily available, as well as the executables for other Linux and Windows as well.
216+
- Pick & choose the binary executable that suits your OS and its architecture. E.g., for Linux, it would most probably be the `{{.Name}}_ver_linux_amd64.tar.gz` file.
217+
- Unzip it and put the executable somewhere in the PATH, after downloading it.
218+
219+
220+
### Install Source
221+
222+
To install the source code instead:
223+
224+
```
225+
go get github.com/suntong/{{.Name}}
226+
```
204227

205228
## Author(s) & Contributor(s)
206229

README.md

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
[![PoweredBy WireFrame](https://github.com/go-easygen/wireframe/blob/master/PoweredBy-WireFrame-B.svg)](http://godoc.org/github.com/go-easygen/wireframe)
1010

1111
## TOC
12+
- [cascadia - CSS selector CLI tool](#cascadia---css-selector-cli-tool)
1213
- [Usage](#usage)
1314
- [$ cascadia](#-cascadia)
1415
- [Examples](#examples)
@@ -18,16 +19,22 @@
1819
- [Twitter Search](#twitter-search)
1920
- [Reconstruct the separated pages](#reconstruct-the-separated-pages)
2021
- [More On CSS Selector](#more-on-css-selector)
21-
- [Author(s) & Contributor(s)](#author(s)-&-contributor(s))
22+
- [Download/Install](#downloadinstall)
23+
- [Download binaries](#download-binaries)
24+
- [Install Source](#install-source)
25+
- [Author(s) & Contributor(s)](#author(s)-&-contributor(s))
26+
27+
## cascadia - CSS selector CLI tool
2228

2329
The [Go Cascadia package](https://github.com/andybalholm/cascadia) implements CSS selectors for html. This is the command line tool, started as a thin wrapper around that package, but growing into a better tool to test CSS selectors without writing Go code:
2430

25-
# Usage
31+
## Usage
2632

2733
#### $ cascadia
2834
```sh
2935
cascadia wrapper
30-
Version 1.2.2 built on 2018-05-22
36+
Version 1.2.3 built on 2020-04-20
37+
Copyright (C) 2020, Tong Sun
3138

3239
Command line interface to go cascadia CSS selectors package
3340

@@ -225,14 +232,35 @@ Collecting as HTML is no trouble either. Here is another example:
225232
226233
The [fifth page is here](http://www.shangxueedu.com/shuxue/ksdg/20170113_162_5.html), and [all pages are collected here](https://docs.google.com/document/d/1StFwP7kChHiGsL-hm3tnY29bsBRQWCU7xdhu2shsGcg/preview). Please check them out.
227234
228-
# More On CSS Selector
235+
## More On CSS Selector
229236
230237
I'm not an expert on CSS Selector at all, but the following resources are what I found most helpful to me.
231238
232239
- [CSS Selectors Cheat Sheet](http://butlerccwebdev.net/support/css-selectors-cheatsheet.html) I think It's very good, because it's usage oriented and very practical, i.e., it arranges the Selectors according to their purposes. If that's too dry for you, check out
233240
- [The 30 CSS Selectors You Must Memorize](http://code.tutsplus.com/tutorials/the-30-css-selectors-you-must-memorize--net-16048) It only lists those selectors that are important, but it gives concrete examples and explanations
234241
- [CSS Selector Reference](http://www.w3schools.com/cssref/css_selectors.asp) from w3schools. This is the one I most often refer to, because the list is comprehensive, and there is also an online [CSS Selector Tester](http://www.w3schools.com/cssref/trysel.asp) that really helped me learn and understand
235242
243+
## Download/Install
244+
245+
246+
### Download binaries
247+
248+
- The latest binary executables are available right under the github release page
249+
https://github.com/suntong/cascadia/releases
250+
as the result of the Continuous-Integration process.
251+
- I.e., they are built during every git tagged push, automatically by [GitHub Actions](https://github.com/features/actions), right from the source code, truely WYSIWYG.
252+
- The `.deb`, `.rpm` and `.apk` packages are readily available, as well as the executables for other Linux and Windows as well.
253+
- Pick & choose the binary executable that suits your OS and its architecture. E.g., for Linux, it would most probably be the `cascadia_ver_linux_amd64.tar.gz` file.
254+
- Unzip it and put the executable somewhere in the PATH, after downloading it.
255+
256+
257+
### Install Source
258+
259+
To install the source code instead:
260+
261+
```
262+
go get github.com/suntong/cascadia
263+
```
236264
237265
## Author(s) & Contributor(s)
238266

0 commit comments

Comments
 (0)