A demonstration of what can be accomplished through CSS-based design. Select any style sheet from the list to load it into this page.
62 | 63 |
154 | {% block body %}{% endblock %}
155 |
156 | 
16 | Perl XML::LibXML by Example by Grant McLean is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License. 17 | -------------------------------------------------------------------------------- /TODO: -------------------------------------------------------------------------------- 1 | * validating XML ? 2 | - handling parse errors 3 | * URI retrieval (e.g. DTD) and the XML catalog 4 | 5 | * customise the sphinx theme for larger font 6 | * add an index: 7 | - http://www.sphinx-doc.org/en/stable/markup/misc.html#index-generating-markup 8 | 9 | * XPath sandbox 10 | - update the URL on submit (allows going back to previous queries) 11 | 12 | Glossary Terms 13 | 14 | * DOM 15 | * element 16 | * node 17 | * Clarkian notation 18 | * document fragment 19 | -------------------------------------------------------------------------------- /images-source/xmllibxml-by-example.xcf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/images-source/xmllibxml-by-example.xcf -------------------------------------------------------------------------------- /images/dom-full.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/images/dom-full.png -------------------------------------------------------------------------------- /images/dom.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/images/dom.png -------------------------------------------------------------------------------- /make-pl-out: -------------------------------------------------------------------------------- 1 | #!/usr/bin/perl 2 | # 3 | # Runs each of the .pl scripts in source/code and captures the output into a 4 | # .pl-out file. 5 | # 6 | # The script first chdir's into the source/code directory so that the scripts 7 | # can simply assume any .xml file is in the current directory. 8 | # 9 | 10 | use 5.010; 11 | use strict; 12 | use warnings; 13 | use autodie; 14 | 15 | 16 | chdir('source/code'); 17 | 18 | my $out_dir = '../_output'; 19 | mkdir($out_dir) unless -d $out_dir; 20 | 21 | my $zip_file = "$out_dir/perl-libxml-examples.zip"; 22 | my $rezip = ! -e $zip_file; 23 | 24 | say "Running example scripts"; 25 | 26 | foreach my $script (sort glob '*.pl') { 27 | my $out_file = "$out_dir/$script-out"; 28 | if(-e $out_file) { 29 | my $script_age = -M $script; 30 | my $output_age = -M $out_file; 31 | next if $script_age > $output_age; 32 | } 33 | say " $script > $out_dir/$script-out 2> $out_dir/$script-err"; 34 | system("./$script > $out_dir/$script-out 2> $out_dir/$script-err") == 0 35 | or exit $? >> 8; 36 | } 37 | 38 | $rezip ||= zip_is_stale(); 39 | if($rezip) { 40 | say "Creating perl-libxml-examples.zip"; 41 | unlink($zip_file) if -e $zip_file; 42 | system("zip $zip_file *") == 0 43 | or exit $? >> 8; 44 | } 45 | 46 | exit; 47 | 48 | sub zip_is_stale { 49 | my $zip_age = -M $zip_file; 50 | foreach my $file (glob '*') { 51 | return 1 if $zip_age > -M $file; 52 | } 53 | return 0; 54 | } 55 | -------------------------------------------------------------------------------- /publish: -------------------------------------------------------------------------------- 1 | #!/usr/bin/perl 2 | ############################################################################## 3 | # 4 | # Publish latest version to GitHub pages site. 5 | # 6 | # Note: To generate the HTML locally and proofread the changes, just use: 7 | # 8 | # make html 9 | # 10 | # Use --help option for more details 11 | # 12 | 13 | use 5.010; 14 | use strict; 15 | use warnings; 16 | use autodie; 17 | 18 | use Pod::Usage; 19 | use Getopt::Long qw(GetOptions); 20 | use POSIX qw(strftime); 21 | 22 | $| = 1; # turn off output buffering for prompt 23 | 24 | 25 | my $generated_dir = 'build/html'; 26 | my $target_dir = '../perl-libxml-by-example-pages'; 27 | 28 | my(%opt); 29 | 30 | if(!GetOptions(\%opt, 'help|?', 'message|m=s', 'dryrun|dry-run')) { 31 | pod2usage(-exitval => 1, -verbose => 0); 32 | } 33 | 34 | pod2usage(-exitstatus => 0, -verbose => 2) if $opt{help}; 35 | 36 | my $message = commit_message(); 37 | check_uncommitted(); 38 | build_all(); 39 | publish_to_gh_pages($message); 40 | 41 | exit; 42 | 43 | 44 | sub commit_message { 45 | if(my $message = $opt{message}) { 46 | my $log = `git log --pretty=oneline -1`; 47 | my($commit_id) = $log =~ m{\A(\w{12})}; 48 | return "$message\n\n Source commit: $commit_id"; 49 | } 50 | elsif($opt{dryrun}) { 51 | return; 52 | } 53 | else { 54 | say "You must specify a commit message with -m"; 55 | say "Recent commits:"; 56 | my $mtime = (stat("$target_dir/.git/index"))[9]; 57 | $mtime = strftime('%F-%T', localtime($mtime)); 58 | my $log = `git log --pretty=format:'%h %s' \@{$mtime}..`; 59 | if($log =~ /\S/) { 60 | say $log; 61 | } 62 | else { 63 | say "No changes in source repo"; 64 | } 65 | exit 1; 66 | } 67 | } 68 | 69 | 70 | sub check_uncommitted { 71 | my $git_status = `git status -s`; 72 | return unless $git_status =~ /\S/; 73 | 74 | say "WARNING: Uncommitted changes ...\n\n$git_status"; 75 | print "Publish anyway? (y/N) "; 76 | 77 | my $response =
2 |
9 |
--------------------------------------------------------------------------------
/source/_templates/epub-cover.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | Project Source
3 |-
4 |
- Project 5 | repository on GitHub 6 |
7 |
10 |
11 |
12 |
13 |
--------------------------------------------------------------------------------
/source/_templates/page.html:
--------------------------------------------------------------------------------
1 | {#
2 | basic/page.html
3 | ~~~~~~~~~~~~~~~
4 |
5 | Master template for simple pages.
6 |
7 | :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
8 | :license: BSD, see LICENSE for details.
9 | #}
10 | {%- extends "layout.html" %}
11 | {%- set script_files = script_files + ["_static/plxbe.js"] %}
12 | {%- set css_files = css_files + ["_static/plxbe.css"] %}
13 | {%- set customsidebar = "customsidebar.html" %}
14 | {% block body %}
15 | {{ body }}
16 | {% endblock %}
17 |
--------------------------------------------------------------------------------
/source/_templates/search.html:
--------------------------------------------------------------------------------
1 | {#
2 | basic/search.html
3 | ~~~~~~~~~~~~~~~~~
4 |
5 | Template for the search page.
6 |
7 | :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
8 | :license: BSD, see LICENSE for details.
9 | #}
10 | {%- extends "layout.html" %}
11 | {%- set script_files = script_files + ["_static/plxbe.js"] %}
12 | {%- set css_files = css_files + ["_static/plxbe.css"] %}
13 | {%- set customsidebar = "customsidebar.html" %}
14 | {% set title = _('Search') %}
15 | {% set script_files = script_files + ['_static/searchtools.js'] %}
16 | {% block footer %}
17 |
20 | {# this is used when loading the search index using $.ajax fails,
21 | such as on Chrome for documents on localhost #}
22 |
23 | {{ super() }}
24 | {% endblock %}
25 | {% block body %}
26 |
34 |
35 | {% if search_performed %}
36 | {{ _('Search Results') }}
37 | {% if not search_results %} 38 |{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}
39 | {% endif %} 40 | {% endif %} 41 |
42 | {% if search_results %}
43 |
53 | {% endblock %}
54 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/__init__.py:
--------------------------------------------------------------------------------
1 | """Sphinx ReadTheDocs theme.
2 |
3 | From https://github.com/ryan-roemer/sphinx-bootstrap-theme.
4 |
5 | """
6 | import os
7 |
8 | VERSION = (0, 1, 9)
9 |
10 | __version__ = ".".join(str(v) for v in VERSION)
11 | __version_full__ = __version__
12 |
13 |
14 | def get_html_theme_path():
15 | """Return list of HTML theme paths."""
16 | cur_dir = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
17 | return cur_dir
18 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/breadcrumbs.html:
--------------------------------------------------------------------------------
1 | {# Support for Sphinx 1.3+ page_source_suffix, but don't break old builds. #}
2 |
3 | {% if page_source_suffix %}
4 | {% set suffix = page_source_suffix %}
5 | {% else %}
6 | {% set suffix = source_suffix %}
7 | {% endif %}
8 |
9 |
32 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/footer.html:
--------------------------------------------------------------------------------
1 |
52 |
53 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/layout.html:
--------------------------------------------------------------------------------
1 | {# TEMPLATE VAR SETTINGS #}
2 | {%- set url_root = pathto('', 1) %}
3 | {%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
4 | {%- if not embedded and docstitle %}
5 | {%- set titlesuffix = " — "|safe + docstitle|e %}
6 | {%- else %}
7 | {%- set titlesuffix = "" %}
8 | {%- endif %}
9 |
10 |
11 |
12 |
13 |
14 |
15 | {{ metatags }}
16 |
17 | {% block htmltitle %}
18 | -
44 | {% for href, caption, context in search_results %}
45 |
-
46 | {{ caption }}
47 |
{{ context|e }}
48 |
49 | {% endfor %}
50 |
86 |
87 | {# SIDE NAV, TOGGLES ON MOBILE #}
88 |
138 |
139 |
140 |
141 | {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
142 |
146 |
147 |
148 | {# PAGE CONTENT #}
149 |
162 |
163 |
164 | {% include "versions.html" %}
165 |
166 | {% if not embedded %}
167 |
168 |
177 | {%- for scriptfile in script_files %}
178 |
179 | {%- endfor %}
180 |
181 | {% endif %}
182 |
183 | {# RTD hosts this file, so just load on non RTD builds #}
184 | {% if not READTHEDOCS %}
185 |
186 | {% endif %}
187 |
188 | {# STICKY NAVIGATION #}
189 | {% if theme_sticky_navigation %}
190 |
195 | {% endif %}
196 |
197 | {%- block footer %} {% endblock %}
198 |
199 |
200 |
201 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/layout_old.html:
--------------------------------------------------------------------------------
1 | {#
2 | basic/layout.html
3 | ~~~~~~~~~~~~~~~~~
4 |
5 | Master layout template for Sphinx themes.
6 |
7 | :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS.
8 | :license: BSD, see LICENSE for details.
9 | #}
10 | {%- block doctype -%}
11 |
13 | {%- endblock %}
14 | {%- set reldelim1 = reldelim1 is not defined and ' »' or reldelim1 %}
15 | {%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %}
16 | {%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and
17 | (sidebars != []) %}
18 | {%- set url_root = pathto('', 1) %}
19 | {# XXX necessary? #}
20 | {%- if url_root == '#' %}{% set url_root = '' %}{% endif %}
21 | {%- if not embedded and docstitle %}
22 | {%- set titlesuffix = " — "|safe + docstitle|e %}
23 | {%- else %}
24 | {%- set titlesuffix = "" %}
25 | {%- endif %}
26 |
27 | {%- macro relbar() %}
28 |
46 | {%- endmacro %}
47 |
48 | {%- macro sidebar() %}
49 | {%- if render_sidebar %}
50 |
150 |
160 |
161 |
151 | {% include "breadcrumbs.html" %}
152 |
159 |
153 |
157 | {% include "footer.html" %}
158 |
51 |
84 | {%- endif %}
85 | {%- endmacro %}
86 |
87 | {%- macro script() %}
88 |
97 | {%- for scriptfile in script_files %}
98 |
99 | {%- endfor %}
100 | {%- endmacro %}
101 |
102 | {%- macro css() %}
103 |
104 |
105 | {%- for cssfile in css_files %}
106 |
107 | {%- endfor %}
108 | {%- endmacro %}
109 |
110 |
111 |
112 |
113 | {{ metatags }}
114 | {%- block htmltitle %}
115 |
52 | {%- block sidebarlogo %}
53 | {%- if logo %}
54 |
57 | {%- endif %}
58 | {%- endblock %}
59 | {%- if sidebars != None %}
60 | {#- new style sidebar: explicitly include/exclude templates #}
61 | {%- for sidebartemplate in sidebars %}
62 | {%- include sidebartemplate %}
63 | {%- endfor %}
64 | {%- else %}
65 | {#- old style sidebars: using blocks -- should be deprecated #}
66 | {%- block sidebartoc %}
67 | {%- include "localtoc.html" %}
68 | {%- endblock %}
69 | {%- block sidebarrel %}
70 | {%- include "relations.html" %}
71 | {%- endblock %}
72 | {%- block sidebarsourcelink %}
73 | {%- include "sourcelink.html" %}
74 | {%- endblock %}
75 | {%- if customsidebar %}
76 | {%- include customsidebar %}
77 | {%- endif %}
78 | {%- block sidebarsearch %}
79 | {%- include "searchbox.html" %}
80 | {%- endblock %}
81 | {%- endif %}
82 |
83 |
164 | {%- block document %}
165 |
181 | {%- endblock %}
182 |
183 | {%- block relbar2 %}{{ relbar() }}{% endblock %}
184 |
185 | {%- block footer %}
186 |
201 |
166 | {%- if render_sidebar %}
167 |
176 | {%- endblock %}
177 |
178 | {%- block sidebar2 %}{{ sidebar() }}{% endblock %}
179 |
180 |
168 | {%- endif %}
169 |
174 | {%- endif %}
175 |
170 | {% block body %} {% endblock %}
171 |
172 | {%- if render_sidebar %}
173 | asdf asdf asdf asdf 22
202 | {%- endblock %} 203 | 204 | 205 | 206 | -------------------------------------------------------------------------------- /source/_themes/sphinx_rtd_theme/search.html: -------------------------------------------------------------------------------- 1 | {# 2 | basic/search.html 3 | ~~~~~~~~~~~~~~~~~ 4 | 5 | Template for the search page. 6 | 7 | :copyright: Copyright 2007-2013 by the Sphinx team, see AUTHORS. 8 | :license: BSD, see LICENSE for details. 9 | #} 10 | {%- extends "layout.html" %} 11 | {% set title = _('Search') %} 12 | {% set script_files = script_files + ['_static/searchtools.js'] %} 13 | {% block footer %} 14 | 17 | {# this is used when loading the search index using $.ajax fails, 18 | such as on Chrome for documents on localhost #} 19 | 20 | {{ super() }} 21 | {% endblock %} 22 | {% block body %} 23 | 31 | 32 | {% if search_performed %} 33 |{{ _('Search Results') }}
34 | {% if not search_results %} 35 |{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}
36 | {% endif %} 37 | {% endif %} 38 |
39 | {% if search_results %}
40 |
50 | {% endblock %}
51 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/searchbox.html:
--------------------------------------------------------------------------------
1 | {%- if builder != 'singlehtml' %}
2 | -
41 | {% for href, caption, context in search_results %}
42 |
-
43 | {{ caption }}
44 |
{{ context|e }}
45 |
46 | {% endfor %}
47 |
3 |
8 |
9 | {%- endif %}
10 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/css/badge_only.css:
--------------------------------------------------------------------------------
1 | .fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-weight:normal;font-style:normal;src:url("../font/fontawesome_webfont.eot");src:url("../font/fontawesome_webfont.eot?#iefix") format("embedded-opentype"),url("../font/fontawesome_webfont.woff") format("woff"),url("../font/fontawesome_webfont.ttf") format("truetype"),url("../font/fontawesome_webfont.svg#FontAwesome") format("svg")}.fa:before{display:inline-block;font-family:FontAwesome;font-style:normal;font-weight:normal;line-height:1;text-decoration:inherit}a .fa{display:inline-block;text-decoration:inherit}li .fa{display:inline-block}li .fa-large:before,li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-0.8em}ul.fas li .fa{width:0.8em}ul.fas li .fa-large:before,ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before{content:""}.icon-book:before{content:""}.fa-caret-down:before{content:""}.icon-caret-down:before{content:""}.fa-caret-up:before{content:""}.icon-caret-up:before{content:""}.fa-caret-left:before{content:""}.icon-caret-left:before{content:""}.fa-caret-right:before{content:""}.icon-caret-right:before{content:""}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;border-top:solid 10px #343131;font-family:"Lato","proxima-nova","Helvetica Neue",Arial,sans-serif;z-index:400}.rst-versions a{color:#2980B9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27AE60;*zoom:1}.rst-versions .rst-current-version:before,.rst-versions .rst-current-version:after{display:table;content:""}.rst-versions .rst-current-version:after{clear:both}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book{float:left}.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#E74C3C;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#F1C40F;color:#000}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:gray;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:solid 1px #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px}.rst-versions.rst-badge .icon-book{float:none}.rst-versions.rst-badge .fa-book{float:none}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book{float:left}.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge .rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width: 768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}img{width:100%;height:auto}}
2 | /*# sourceMappingURL=badge_only.css.map */
3 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/css/badge_only.css.map:
--------------------------------------------------------------------------------
1 | {
2 | "version": 3,
3 | "mappings": "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",
4 | "sources": ["../../../bower_components/wyrm/sass/wyrm_core/_mixin.sass","../../../bower_components/bourbon/dist/css3/_font-face.scss","../../../sass/_theme_badge_fa.sass","../../../sass/_theme_badge.sass","../../../bower_components/wyrm/sass/wyrm_core/_wy_variables.sass","../../../sass/_theme_variables.sass","../../../bower_components/neat/app/assets/stylesheets/grid/_media.scss"],
5 | "names": [],
6 | "file": "badge_only.css"
7 | }
8 |
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/FontAwesome.otf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/Inconsolata-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/Inconsolata-Bold.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/Inconsolata-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/Inconsolata-Regular.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/Lato-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/Lato-Bold.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/Lato-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/Lato-Regular.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/_themes/sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff
--------------------------------------------------------------------------------
/source/_themes/sphinx_rtd_theme/static/js/modernizr.min.js:
--------------------------------------------------------------------------------
1 | /* Modernizr 2.6.2 (Custom Build) | MIT & BSD
2 | * Build: http://modernizr.com/download/#-fontface-backgroundsize-borderimage-borderradius-boxshadow-flexbox-hsla-multiplebgs-opacity-rgba-textshadow-cssanimations-csscolumns-generatedcontent-cssgradients-cssreflections-csstransforms-csstransforms3d-csstransitions-applicationcache-canvas-canvastext-draganddrop-hashchange-history-audio-video-indexeddb-input-inputtypes-localstorage-postmessage-sessionstorage-websockets-websqldatabase-webworkers-geolocation-inlinesvg-smil-svg-svgclippaths-touch-webgl-shiv-mq-cssclasses-addtest-prefixed-teststyles-testprop-testallprops-hasevent-prefixes-domprefixes-load
3 | */
4 | ;window.Modernizr=function(a,b,c){function D(a){j.cssText=a}function E(a,b){return D(n.join(a+";")+(b||""))}function F(a,b){return typeof a===b}function G(a,b){return!!~(""+a).indexOf(b)}function H(a,b){for(var d in a){var e=a[d];if(!G(e,"-")&&j[e]!==c)return b=="pfx"?e:!0}return!1}function I(a,b,d){for(var e in a){var f=b[a[e]];if(f!==c)return d===!1?a[e]:F(f,"function")?f.bind(d||b):f}return!1}function J(a,b,c){var d=a.charAt(0).toUpperCase()+a.slice(1),e=(a+" "+p.join(d+" ")+d).split(" ");return F(b,"string")||F(b,"undefined")?H(e,b):(e=(a+" "+q.join(d+" ")+d).split(" "),I(e,b,c))}function K(){e.input=function(c){for(var d=0,e=c.length;d
4 |
5 | Read the Docs
6 | v: {{ current_version }}
7 |
8 |
9 |
36 | {% endif %}
37 |
38 |
--------------------------------------------------------------------------------
/source/basics.rst:
--------------------------------------------------------------------------------
1 | .. highlight:: none
2 | :linenothreshold: 1
3 |
4 | A Basic Example
5 | ===============
6 |
7 | The first thing you'll need is an XML document. The example programs in this
8 | section will use the :download:`playlist.xml `
9 | file shown below. This file contains details of five different movies:
10 |
11 | .. literalinclude:: /code/playlist.xml
12 | :language: xml
13 | :linenos:
14 |
15 | .. note::
16 |
17 | Although this XML document contains details which came from the fabulous
18 | `IMDb.com
10 |
32 | Free document hosting provided by Read the Docs. 33 | 34 |
35 | -
11 |
- Versions 12 | {% for slug, url in versions %} 13 |
- {{ slug }} 14 | {% endfor %} 15 |
-
17 |
- Downloads 18 | {% for type, url in downloads %} 19 |
- {{ type }} 20 | {% endfor %} 21 |
-
23 |
- On Read the Docs 24 |
- 25 | Project Home 26 | 27 |
- 28 | Builds 29 | 30 |
32 | Free document hosting provided by Read the Docs. 33 | 34 |
53 |
54 |
55 |
56 |
59 |
60 |
72 |
73 |
186 |
187 |
194 |
195 |
196 |
197 |
198 |
--------------------------------------------------------------------------------
/source/code/enwiki-latest-abstract1-abridged.xml.gz:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/grantm/perl-libxml-by-example/e2e8a4d17cd9afbcd6d57379277d709b7341b73e/source/code/enwiki-latest-abstract1-abridged.xml.gz
--------------------------------------------------------------------------------
/source/code/enwiki-latest-abstract1-structure.xml:
--------------------------------------------------------------------------------
1 | CSS Zen Garden
57 |The Beauty of CSS Design
58 |
61 |
64 |
65 |
66 |
71 | The Road to Enlightenment
67 |Littering a dark and dreary road lay the past relics of browser-specific tags, incompatible DOMs, broken CSS support, and abandoned browsers.
68 |We must clear the mind of the past. Web enlightenment has been achieved thanks to the tireless efforts of folk like the W3C, WaSP, and the major browser creators.
69 |The CSS Zen Garden invites you to relax and meditate on the important lessons of the masters. Begin to see with clarity. Learn to use the time-honored techniques in new and invigorating fashion. Become one with the web.
70 |
74 |
110 |
111 |
112 |
183 |
184 |
185 |
75 |
79 |
80 | So What is This About?
76 |There is a continuing need to show the power of CSS. The Zen Garden aims to excite, inspire, and encourage participation. To begin, view some of the existing designs in the list. Clicking on any one will load the style sheet into this very page. The HTML remains the same, the only thing that has changed is the external CSS file. Yes, really.
77 |CSS allows complete and total control over the style of a hypertext document. The only way this can be illustrated in a way that gets people excited is by demonstrating what it can truly be, once the reins are placed in the hands of those able to create beauty from structure. Designers and coders alike have contributed to the beauty of the web; we can always push it further.
78 |
81 |
86 |
87 | Participation
82 |Strong visual design has always been our focus. You are modifying this page, so strong CSS skills are necessary too, but the example files are commented well enough that even CSS novices can use them as starting points. Please see the CSS Resource Guide for advanced tutorials and tips on working with CSS.
83 |You may modify the style sheet in any way you wish, but not the HTML. This may seem daunting at first if you’ve never worked this way before, but follow the listed links to learn more, and use the sample files as a guide.
84 |Download the sample HTML and CSS to work on a copy locally. Once you have completed your masterpiece (and please, don’t submit half-finished work) upload your CSS file to a web server under your control. Send us a link to an archive of that file and all associated assets, and if we choose to use it we will download it and place it on our server.
85 |
88 |
91 |
92 | Benefits
89 |Why participate? For recognition, inspiration, and a resource we can all refer to showing people how amazing CSS really can be. This site serves as equal parts inspiration for those working on the web today, learning tool for those who will be tomorrow, and gallery of future techniques we can all look forward to.
90 |
93 |
100 |
101 |
108 |
109 | Requirements
94 |Where possible, we would like to see mostly CSS 1 & 2 usage. CSS 3 & 4 should be limited to widely-supported elements only, or strong fallbacks should be provided. The CSS Zen Garden is about functional, practical CSS and not the latest bleeding-edge tricks viewable by 2% of the browsing public. The only real requirement we have is that your CSS validates.
95 |Luckily, designing this way shows how well various browsers have implemented CSS by now. When sticking to the guidelines you should see fairly consistent results across most modern browsers. Due to the sheer number of user agents on the web these days — especially when you factor in mobile — pixel-perfect layouts may not be possible across every platform. That’s okay, but do test in as many as you can. Your design should work in at least IE9+ and the latest Chrome, Firefox, iOS and Android browsers (run by over 90% of the population).
96 |We ask that you submit original artwork. Please respect copyright laws. Please keep objectionable material to a minimum, and try to incorporate unique and interesting visual themes to your work. We’re well past the point of needing another garden-related design.
97 |This is a learning exercise as well as a demonstration. You retain full copyright on your graphics (with limited exceptions, see submission guidelines), but we ask you release your CSS under a Creative Commons license identical to the one on this site so that others may learn from your work.
98 |By Dave Shea. Bandwidth graciously donated by mediatemple. Now available: Zen Garden, the book.
99 |Present
8 |-
9 |
- Catherine Trenton 10 |
- Daniel Ifflehirst 11 |
- Finlay Doyle 12 |
- Grechny Polnokov 13 |
- Heather Dalton 14 |
- Lester Strang 15 |
Here's a paragraph with poorly nested 3 | tags. Followed by a list of items — with unclosed tags
4 |- red
- orange
- yellow
`` and is even able to recover from parse errors caused by poorly 12 | formed HTML. 13 | 14 | Let's start with this mess of HTML tag soup: 15 | 16 | .. literalinclude:: /code/untidy.html 17 | :language: none 18 | 19 | To read the file in, you'd use the ``load_html()`` method rather than 20 | ``load_xml()``. You'll almost certainly want to use the ``recover => 1`` 21 | option to tell the parser to try to recover from parse errors and carry on to 22 | produce a DOM. 23 | 24 | .. literalinclude:: /code/500-html-tidy.pl 25 | :language: perl 26 | 27 | When the DOM is serialised with ``toStringHTML()``, some rudimentary formatting 28 | is applied automatically. Unfortunately there is no option to add indenting 29 | to the HTML output: 30 | 31 | .. literalinclude:: /_output/500-html-tidy.pl-out 32 | :language: none 33 | 34 | While the document is being parsed, you'll see messages like this on STDERR: 35 | 36 | .. literalinclude:: /_output/500-html-tidy.pl-err 37 | :language: none 38 | 39 | You can turn off the error output with the ``suppress_errors`` option: 40 | 41 | .. literalinclude:: /code/501-html-tidy-no-err.pl 42 | :language: perl 43 | :lines: 11-15 44 | 45 | That option doesn't seem to work with all versions of ``XML::LibXML`` so you 46 | may want to use a routine like this that sends STDERR to ``/dev/null`` during 47 | parsing, but still allows other output to STDERR when the parse function 48 | returns: 49 | 50 | .. literalinclude:: /code/510-html-no-stderr.pl 51 | :language: perl 52 | :lines: 7,17-28 53 | 54 | Querying HTML with XPath 55 | ------------------------ 56 | 57 | The main tool you'll use for extracting data from HTML is the ``findnodes()`` 58 | method that was introduced in :doc:`basics` and :doc:`xpath`. For these 59 | examples, the source HTML comes from the `CSS Zen Garden Project 60 |