12.209 emacspeak-we

we is for webedit Invoke XSLT to edit/transform Web pages before they get rendered. we makes emacspeak’s webedit layer independent of a given Emacs web browser EWW This module will use the abstraction provided by browse-url to handle Web pages.

12.209.1 Emacspeak-We Commands

12.209.1.1 emacspeak-we-class-follow-and-filter

Command: emacspeak-we-class-follow-and-filter (class url &optional prompt)
C-e x e y
Follow url and point, and filter the result by specified class.
Class can be set locally for a buffer, and overridden with an
interactive prefix arg. If there is a known rewrite url rule, that is
used as well.

(fn CLASS URL &optional PROMPT)

12.209.1.3 emacspeak-we-count-matches

Command: emacspeak-we-count-matches (url locator)
C-e x e C-f
Count matches for locator  in Web page.

(fn URL LOCATOR)

12.209.1.4 emacspeak-we-count-nested-tables

Command: emacspeak-we-count-nested-tables (url)
C-e x e C-x
Count nested tables in Web page.

(fn URL)

12.209.1.5 emacspeak-we-count-tables

Command: emacspeak-we-count-tables (url)
C-e x e C-t
Count  tables in Web page.

(fn URL)

12.209.1.6 emacspeak-we-extract-by-class

Command: emacspeak-we-extract-by-class (class url &optional speak)
C-e x e c
Extract elements having specified class attribute from HTML. Extracts
specified elements from current WWW page and displays it in a separate
buffer. Interactive use provides list of class values as completion.

(fn CLASS URL &optional SPEAK)

12.209.1.7 emacspeak-we-extract-by-class-list

Command: emacspeak-we-extract-by-class-list (classes url &optional speak)
C-e x e C
Extract elements having class specified in list ‘classes’ from HTML.
Extracts specified elements from current WWW page and displays it
in a separate buffer.  Interactive use provides list of class
values as completion. 

(fn CLASSES URL &optional SPEAK)

12.209.1.8 emacspeak-we-extract-by-id

Command: emacspeak-we-extract-by-id (id url &optional speak)
C-e x e i
Extract elements having specified id attribute from HTML. Extracts
specified elements from current WWW page and displays it in a
separate buffer.  Interactive use prompts for   id values using
completion.

(fn ID URL &optional SPEAK)

12.209.1.9 emacspeak-we-extract-by-id-list

Command: emacspeak-we-extract-by-id-list (ids url &optional speak)
C-e x e I
Extract elements having id specified in list ‘ids’ from HTML.
Extracts specified elements from current WWW page and displays it in a
separate buffer. Interactive use provides list of id values as completion. 

(fn IDS URL &optional SPEAK)

12.209.1.10 emacspeak-we-extract-by-role

Command: emacspeak-we-extract-by-role (role url &optional speak)
C-e x e r
Extract elements having specified role attribute from HTML. Extracts
specified elements from current WWW page and displays it in a separate
buffer. Interactive use provides list of role values as completion.

(fn ROLE URL &optional SPEAK)

12.209.1.11 emacspeak-we-extract-matching-urls

Command: emacspeak-we-extract-matching-urls (pattern url &optional speak)
C-e x e u
Extracts links whose URL matches pattern.

(fn PATTERN URL &optional SPEAK)

12.209.1.12 emacspeak-we-extract-nested-table

Command: emacspeak-we-extract-nested-table (index url &optional speak)
C-e x e x
Extract nested table specified by ‘table-index’. Default is to
operate on current web page when in a browser buffer; otherwise
prompt for URL. Optional arg ‘speak’ specifies if the result should be
spoken automatically.

(fn INDEX URL &optional SPEAK)

12.209.1.13 emacspeak-we-extract-nested-table-list

Command: emacspeak-we-extract-nested-table-list (tables url &optional speak)
C-e x e X
Extract specified list of tables from a Web page.

(fn TABLES URL &optional SPEAK)

12.209.1.14 emacspeak-we-extract-speakable

Command: emacspeak-we-extract-speakable (url &optional speak)
C-e x e z
Extract elements having class‘speakable’ from HTML. 

(fn URL &optional SPEAK)

12.209.1.15 emacspeak-we-extract-table-by-match

Command: emacspeak-we-extract-table-by-match (match url &optional speak)
C-e x e m
Extract table containing  specified match.
 Optional arg url specifies the page to extract content from.

(fn MATCH URL &optional SPEAK)

12.209.1.16 emacspeak-we-extract-table-by-position

Command: emacspeak-we-extract-table-by-position (pos url &optional speak)
C-e x e t
Extract table at specified pos.
Default is to extract from current page.

(fn POS URL &optional SPEAK)

12.209.1.17 emacspeak-we-extract-tables-by-match-list

Command: emacspeak-we-extract-tables-by-match-list (match-list url &optional speak)
C-e x e M
Extract specified  tables from a WWW page.
Tables are specified by containing  match pattern
 found in the match list.

(fn MATCH-LIST URL &optional SPEAK)

12.209.1.18 emacspeak-we-extract-tables-by-position-list

Command: emacspeak-we-extract-tables-by-position-list (positions url &optional speak)
C-e x e T
Extract specified list of nested tables from a WWW page.
Tables are specified by their position in the list
 of nested tables found in the page.

(fn POSITIONS URL &optional SPEAK)

12.209.1.19 emacspeak-we-follow-and-extract-main

Command: emacspeak-we-follow-and-extract-main (&optional speak)
C-e x e P
Follow URL, then extract role=main.

(fn &optional SPEAK)

12.209.1.20 emacspeak-we-follow-and-filter-by-id

Command: emacspeak-we-follow-and-filter-by-id (id prompt)
C-e x e b
Follow url and point, and filter the result by specified id.
Id can be set locally for a buffer, and overridden with an
interactive prefix arg. If there is a known rewrite url rule, that is
used as well.

(fn ID PROMPT)

12.209.1.21 emacspeak-we-junk-by-class

Command: emacspeak-we-junk-by-class (class url &optional speak)
C-e x e d
Extract elements not having specified class attribute from HTML. Extracts
specified elements from current WWW page and displays it in a separate
buffer. Interactive use provides list of class values as completion.

(fn CLASS URL &optional SPEAK)

12.209.1.22 emacspeak-we-junk-by-class-list

Command: emacspeak-we-junk-by-class-list (classes url &optional speak)
C-e x e D
C-e x e C-c
Extract elements not having class specified in list ‘classes’ from HTML.
Extracts specified elements from current WWW page and displays it
in a separate buffer.  Interactive use provides list of class
values as completion. 

(fn CLASSES URL &optional SPEAK)

12.209.1.23 emacspeak-we-style-filter

Command: emacspeak-we-style-filter (style url &optional speak)
C-e x e S
Extract elements matching specified style
from HTML.  Extracts specified elements from current WWW
page and displays it in a separate buffer.  Optional arg url
specifies the page to extract contents  from.

(fn STYLE URL &optional SPEAK)

12.209.1.24 emacspeak-we-toggle-xsl-keep-result

Command: emacspeak-we-toggle-xsl-keep-result
C-e x e k
Toggle xsl keep result flag.

12.209.1.25 emacspeak-we-url-expand-and-execute

Command: emacspeak-we-url-expand-and-execute (&optional prefix)
C-e x e e
Applies buffer-specific URL expander/executor function.

(fn &optional PREFIX)

12.209.1.26 emacspeak-we-url-rewrite-and-follow

Command: emacspeak-we-url-rewrite-and-follow (&optional prompt)
C-e x e ]
Apply a url rewrite rule as specified in the current buffer
before following link under point.  If no rewrite rule is
defined, first prompt for one.  Rewrite rules are of the
form ‘(from to)’ where from and to are strings.  Typically, the
rewrite rule is automatically set up by Emacspeak tools like
websearch where a rewrite rule is known.  Rewrite rules are
useful in jumping directly to the printer friendly version of an
article for example.  Optional interactive prefix arg prompts for
a rewrite rule even if one is already defined.

(fn &optional PROMPT)

12.209.1.27 emacspeak-we-xpath-follow-and-filter

Command: emacspeak-we-xpath-follow-and-filter (&optional prompt)
C-e x e p
Follow url and point, and filter the result by specified xpath.
XPath can be set locally for a buffer, and overridden with an
interactive prefix arg. If there is a known rewrite url rule, that is
used as well.

(fn &optional PROMPT)

12.209.1.28 emacspeak-we-xpath-junk-and-follow

Command: emacspeak-we-xpath-junk-and-follow (&optional prompt)
C-e x e C-p
Follow url and point, and filter the result by junking
elements specified by xpath.
XPath can be set locally for a buffer, and overridden with an
interactive prefix arg. If there is a known rewrite url rule, that is
used as well.

(fn &optional PROMPT)

12.209.1.29 emacspeak-we-xsl-toggle

Command: emacspeak-we-xsl-toggle
C-e x e o
Toggle  application of XSL transformations.

12.209.1.30 emacspeak-we-xslt-apply

Command: emacspeak-we-xslt-apply (xsl)
C-e x e a
Apply specified transformation to current Web page.

(fn XSL)

12.209.1.31 emacspeak-we-xslt-filter

Command: emacspeak-we-xslt-filter (path url &optional speak)
C-e x e f
Extract elements matching specified XPath path locator
from Web page – default is the current page being viewed.

(fn PATH URL &optional SPEAK)

12.209.1.32 emacspeak-we-xslt-junk

Command: emacspeak-we-xslt-junk (path url &optional speak)
C-e x e j
Junk elements matching specified locator.

(fn PATH URL &optional SPEAK)

12.209.1.33 emacspeak-we-xslt-select

Command: emacspeak-we-xslt-select (xsl)
C-e x e s
Select XSL transformation applied to Web pages before they are displayed .

(fn XSL)

12.209.2 emacspeak-we Options

Variable: User Option emacspeak-we-filters-rename-buffer
Set to T  if you want the buffer name to contain the applied filter.

Default Value:

nil