diff --git a/readme.md b/readme.md
index 1da2753..076bba3 100644
--- a/readme.md
+++ b/readme.md
@@ -5,6 +5,7 @@
[](https://www.nuget.org/packages/Devlooped.Web)
[](https://github.com/devlooped/web/blob/main/license.txt)
+
Read HTML as XML and query it with CSS over XLinq.
No need to learn an entirely new object model for a page 🤘.
@@ -32,6 +33,29 @@ receiving an `HtmlReaderSettings`.
The underlying parsing is performed by the amazing [SgmlReader](https://www.nuget.org/packages/Microsoft.Xml.SgmlReader)
library by Microsoft's [Chris Lovett](http://lovettsoftware.com/).
+In addition, the following extension methods make it easier to work
+with XML documents where you want to query with CSS or XPath without
+having to deal with XML namespaces:
+
+```csharp
+using System.Xml;
+using System.Xml.Linq;
+using Devlooped.Web;
+
+var doc = XDocument.Load("doc.xml")
+// Will remove all xmlns declarations, and allow querying elements
+// as if none had namespaces, returns the root element
+XElement nons = doc.RemoveNamespaces();
+
+// Alternatively, you can also ignore at the XmlReader level
+using var reader = XmlReader.Create("doc.xml").IgnoreNamespaces();
+doc = XDocument.Load(reader);
+
+// Finally, you can also skip elements at the reader level
+using var reader = XmlReader.Create("doc.xml").SkipElements("foo", "bar");
+doc = XDocument.Load(reader);
+```
+
## CSS
At the moment, supports the following CSS selector features:
@@ -76,6 +100,8 @@ Non-CSS features:
* `[text()*=val]`: Represents an element whose text contents contains at least one instance of the
substring "val". If "val" is the empty string then the selector does not represent anything.
+
+
# Dogfooding
[](https://pkg.kzu.io/index.json)
@@ -91,6 +117,7 @@ The versioning scheme for packages is:
- Branch builds: *42.42.42-*`[BRANCH]`.`[COMMITS]`
+
# Sponsors
diff --git a/src/Tests/XmlTests.cs b/src/Tests/XmlTests.cs
new file mode 100644
index 0000000..c2c1178
--- /dev/null
+++ b/src/Tests/XmlTests.cs
@@ -0,0 +1,43 @@
+using System.Xml;
+using System.Xml.Linq;
+using System.Xml.XPath;
+
+namespace Tests;
+
+public record XmlTests(ITestOutputHelper Output)
+{
+ [Fact]
+ public void RemoveNamespacesFromElement()
+ {
+ var doc = XDocument.Load("package.opf");
+ var nons = doc.Root!.RemoveNamespaces();
+
+ var xmlns = new XmlNamespaceManager(new NameTable());
+ xmlns.AddNamespace("opf", "http://www.idpf.org/2007/opf");
+ xmlns.AddNamespace("dc", "http://purl.org/dc/elements/1.1/");
+
+ var yearns = doc.XPathSelectElement("/opf:package/opf:metadata/opf:meta[@property='dcterms:date']", xmlns)?.Value;
+
+ // NOTE: since we're at the element level now, we don't need to reference the root element
+ var year = nons.XPathSelectElement("/metadata/meta[@property='dcterms:date']")?.Value;
+
+ //Output.WriteLine(doc.Root!.Elements().First().ToString());
+ //Output.WriteLine(nons.Elements().First().ToString());
+
+ Assert.NotNull(yearns);
+ Assert.NotNull(year);
+
+ Assert.Equal(yearns, year);
+ }
+
+ [Fact]
+ public void RemoveElementsFromReader()
+ {
+ using var reader = XmlReader.Create("package.opf").SkipElements("manifest");
+ var doc = XDocument.Load(reader);
+
+ var all = XDocument.Load("package.opf");
+
+ Assert.NotEqual(doc.Root!.Elements().Count(), all.Root!.Elements().Count());
+ }
+}
diff --git a/src/Tests/package.opf b/src/Tests/package.opf
new file mode 100644
index 0000000..2cfb694
--- /dev/null
+++ b/src/Tests/package.opf
@@ -0,0 +1,229 @@
+
+
+
+ Gideon the Ninth
+ 9781250313171
+ 15
+ en-US
+ Tamsyn Muir
+ Tom Doherty Associates
+ urn:isbn:9781250313188
+ 15
+ All rights reserved
+ main
+ 2020-03-11T20:41:25Z
+ Tamsyn Muir
+ 2020
+ auto
+ auto
+
+ textual
+ textual,visual
+ structuralNavigation
+ This publication conforms to the EPUB Accessibility specification at WCAG Level A.
+
+
+