mirror of
https://github.com/rmcrackan/Libation.git
synced 2026-10-28 08:29:11 -04:00
docs: drop Neil Gaiman from the examples
Replaced with Stephen Fry, who the search and naming-template docs already use as a narrator and who writes and narrates his own books, so the author-narrator examples still say what they meant to. The one code mention is a comment describing how Audible builds a contributor URL. It used his real author page and id; the point being made is that the name in the path is decorative, so a placeholder id makes it better, not worse. Two things fell out of editing the narrator format line. Its template printed '\) ' - a backslash inside quotes that already make the paren literal - so it produced "Arthur (Conan\) Doyle", not the output printed beside it. And the line is raw HTML rather than backticks, so markdown ate the backslash before the opening paren, leaving the website showing a different template from the markdown. Both spellings produce the documented output; the line now uses the one that survives rendering, so source and page agree. The screenshot for the author-narrator search showed a Gaiman query, so it is replaced by the query inline. The now-unreferenced image is removed with it. Co-authored-by: rmcrackan <rmcrackan@gmail.com>
This commit is contained in:
5 files changed
+11
-10
No files matched your search
@@ -16,11 +16,12 @@ public class Contributor
|
||||
|
||||
// id.s
|
||||
// ----
|
||||
// https://www.audible.com/author/Neil-Gaiman/B000AQ01G2 == https://www.audible.com/author/B000AQ01G2
|
||||
// the name in the path is decorative; the id is what resolves it. Both of these reach the same page:
|
||||
// https://www.audible.com/author/Robert-Bevan/B0EXAMPLE1 == https://www.audible.com/author/B0EXAMPLE1
|
||||
// goes to summary page
|
||||
// at bottom "See all titles by Neil Gaiman" goes to https://www.audible.com/search?searchAuthor=Neil+Gaiman
|
||||
// at bottom "See all titles by Robert Bevan" goes to https://www.audible.com/search?searchAuthor=Robert+Bevan
|
||||
// some authors have no id. simply goes to https://www.audible.com/search?searchAuthor=Rufus+Fears
|
||||
// all narrators have no id: https://www.audible.com/search?searchNarrator=Neil+Gaiman
|
||||
// all narrators have no id: https://www.audible.com/search?searchNarrator=Robert+Bevan
|
||||
|
||||
internal int ContributorId { get; private set; }
|
||||
public string Name { get; private set; }
|
||||
|
||||
@@ -14,13 +14,13 @@ Search the title for the phrase "sign of the four". Without the quotes these wou
|
||||
|
||||
`title:"sign of the four"`
|
||||
|
||||
Search for books Neil Gaiman wrote and also narrated. Without `AND` you would get everything he wrote plus everything anyone narrated of their own.
|
||||
Search for books Stephen Fry wrote and also narrated. Without `AND` you would get everything he wrote plus everything anyone narrated of their own.
|
||||
|
||||
`author:gaiman AND narrator:gaiman`
|
||||
`author:fry AND narrator:fry`
|
||||
|
||||
Group terms with parentheses to combine `AND` and `OR` in one query.
|
||||
|
||||
`(author:doyle AND narrator:fry) OR title:gods`
|
||||
`(author:doyle AND narrator:fry) OR title:mythos`
|
||||
|
||||
Search for books by Doyle that Fry did not narrate. `-` and `NOT` mean the same thing.
|
||||
|
||||
@@ -28,7 +28,7 @@ Search for books by Doyle that Fry did not narrate. `-` and `NOT` mean the same
|
||||
|
||||
Exclude a group of alternatives at once.
|
||||
|
||||
`-(narrator:fry OR narrator:jacobi)`
|
||||
`-(title:hound OR title:study)`
|
||||
|
||||
## Wildcard matching
|
||||
|
||||
|
||||
@@ -308,7 +308,7 @@ The format template must sometimes be enclosed in square brackets and sometimes
|
||||
Not all elements of a property are always present or have content. In this case, format templates would contain gaps after substitution. Groups of spaces are automatically merged. Other characters, however, remain unchanged. By doubling the curly brackets, you can specify text fragments before and after the placeholder, which are only used if the placeholder is replaced with content.
|
||||
|
||||
<!-- VitePress compiles each .md as a Vue SFC: a literal `{{` inside normal backtick `code` is treated as Vue interpolation and breaks the build. Elsewhere this doc uses backticks for inline examples; this line is HTML `code` with `v-pre` so `{{` can be written literally and still render like the other snippets, without additional hacks such as obscure invisible characters (like ÈB : 0-width space). -->
|
||||
<code v-pre><narrator[format({{F} }{\({M}'\) '}{L})]></code> -> <code>Neil Gaiman, Christopher (Evan) Welch</code>
|
||||
<code v-pre><narrator[format({{F} }{({M}') '}{L})]></code> -> <code>Stephen Fry, Arthur (Conan) Doyle</code>
|
||||
|
||||
### Checks
|
||||
|
||||
|
||||
@@ -45,9 +45,9 @@ If you only want to see potter except for Harry Potter. You can also use "-" ins
|
||||

|
||||

|
||||
|
||||
To see only books written by Neil Gaiman where he also narrates his own book. (If you don't include AND, you'll see everything written by Neil Gaiman and also all books in your library which are self-narrated.)
|
||||
To see only books written by Stephen Fry where he also narrates his own book. (If you don't include AND, you'll see everything written by Stephen Fry and also all books in your library which are self-narrated.)
|
||||
|
||||

|
||||
`author:fry AND authornarrated`
|
||||
|
||||
I tagged autobiographies as auto_bio and biographies written by someone else as bio. I can get only autobiographies with \[auto_bio\] or get both by searching \[bio\]
|
||||
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 46 KiB |
Reference in new issue
Block a user