Document not found (404)
+This URL is invalid, sorry. Please use the navigation bar or search to continue.
+ +diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..3c3629e --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +node_modules diff --git a/bins/LICENSE b/bins/LICENSE new file mode 100644 index 0000000..20ec44b --- /dev/null +++ b/bins/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2018 Michael Bryan + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/bins/README.md b/bins/README.md new file mode 100644 index 0000000..90f59c2 --- /dev/null +++ b/bins/README.md @@ -0,0 +1,166 @@ +# MDBook Link-Check + +[![Continuous integration](https://github.com/Michael-F-Bryan/mdbook-linkcheck/workflows/Continuous%20integration/badge.svg?branch=master)](https://github.com/Michael-F-Bryan/mdbook-linkcheck/actions) +[![Crates.io](https://img.shields.io/crates/v/mdbook-linkcheck.svg)](https://crates.io/crates/mdbook-linkcheck) +[![Docs.rs](https://docs.rs/mdbook-linkcheck/badge.svg)](https://docs.rs/mdbook-linkcheck/) +[![license](https://img.shields.io/github/license/michael-f-bryan/mdbook-linkcheck.svg)](https://github.com/Michael-F-Bryan/mdbook-linkcheck/blob/master/LICENSE) + +A backend for `mdbook` which will check your links for you. For use alongside +the built-in HTML renderer. + +## Getting Started + +First you'll need to install `mdbook-linkcheck`. + +``` +cargo install mdbook-linkcheck +``` + +If you don't want to install from source (which often takes a while) you can +grab an executable from [GitHub Releases][releases] or use this line of +`curl`: + +```console +curl -s https://api.github.com/repos/Michael-F-Bryan/mdbook-linkcheck/releases/latest \ + | grep browser_download_url \ + | grep $(rustc -Vv | grep host | cut -d' ' -f2) \ + | cut -d : -f 2,3 \ + | tr -d \" \ + | wget -qi - +``` + +Next you'll need to update your `book.toml` to let `mdbook` know it needs to +use `mdbook-linkcheck` as a backend. + +```toml +[book] +title = "My Awesome Book" +authors = ["Michael-F-Bryan"] + +[output.html] + +[output.linkcheck] +``` + +And finally you should be able to run `mdbook build` like normal and everything +should *Just Work*. + +``` +$ mdbook build +``` + +> **Note:** When multiple `[output]` items are specified, `mdbook` tries to +> ensure that each `[output]` gets its own sub-directory within the `build-dir` +> (`book/` by default). +> +> That means if you go from only having the HTML renderer enabled to enabling +> both HTML and the linkchecker, your HTML will be placed in `book/html/` +> instead of just `book/` like before. + +## Configuration + +The link checker's behaviour can be configured by setting options under the +`output.linkcheck` table in your `book.toml`. + +```toml +... + +[output.linkcheck] +# Should we check links on the internet? Enabling this option adds a +# non-negligible performance impact +follow-web-links = false + +# Are we allowed to link to files outside of the book's root directory? This +# may help prevent linking to sensitive files (e.g. "../../../../etc/shadow") +traverse-parent-directories = false + +# If necessary, you can exclude one or more links from being checked with a +# list of regular expressions. The regex will be applied to the link href (i.e. +# the `./index.html` in `[some page](./index.html)`) so it can be used to +# ignore both web and filesystem links. +# +# Hint: you can use TOML's raw strings (single quote) to avoid needing to +# escape things twice. +exclude = [ 'google\.com' ] + +# The User-Agent to use when sending web requests +user-agent = "mdbook-linkcheck-0.4.0" + +# The number of seconds a cached result is valid for (12 hrs by default) +cache-timeout = 43200 + +# How should warnings be treated? +# +# - "warn" will emit warning messages +# - "error" treats all warnings as errors, failing the linkcheck +# - "ignore" will ignore warnings, suppressing diagnostic messages and allowing +# the linkcheck to continuing +warning-policy = "warn" + +# Extra HTTP headers that must be send to certain web sites +# in order to link check to succeed. +# +# This is a dictionary (map), with keys being regexes +# matching a set of web sites, and values being an array of +# the headers. +[output.linkcheck.http-headers] +# Any hyperlink that contains this regexp will be sent +# the "Accept: text/html" header +'crates\.io' = ["Accept: text/html"] + +# mdbook-linkcheck will interpolate environment variables into your header via +# $IDENT. +# +# If this is not what you want you must escape the `$` symbol, like `\$TOKEN`. +# `\` itself can also be escaped via `\\`. +# +# Note: If interpolation fails, the header will be skipped and the failure will +# be logged. This can be useful if a particular header isn't always necessary, +# but may be helpful (e.g. when working with rate limiting). +'website\.com' = ["Authorization: Basic $TOKEN"] +``` + +## Continuous Integration + +Incorporating `mdbook-linkcheck` into your CI system should be straightforward +if you are already [using `mdbook` to generate documentation][mdbook-ci]. + +For those using GitLab's built-in CI: + +```yaml +generate-book: + stage: build + image: + name: michaelfbryan/mdbook-docker-image:latest + entrypoint: [""] + script: + - mdbook build $BOOK_DIR + artifacts: + paths: + - $BOOK_DIR/book/html + # make sure GitLab doesn't accidentally keep every book you ever generate + # indefinitely + expire_in: 1 week + +pages: + image: busybox:latest + stage: deploy + dependencies: + - generate-book + script: + - cp -r $BOOK_DIR/book/html public + artifacts: + paths: + - public + only: + - master +``` + +The [michaelfbryan/mdbook-docker-image][image] docker image is also available +on Docker hub and comes with the latest version of `mdbook` and +`mdbook-linkcheck` pre-installed. + +[releases]: https://github.com/Michael-F-Bryan/mdbook-linkcheck/releases +[mdbook-ci]: https://rust-lang.github.io/mdBook/continuous-integration.html +[Michael-F-Bryan]: https://github.com/Michael-F-Bryan +[image]: https://hub.docker.com/r/michaelfbryan/mdbook-docker-image diff --git a/bins/linkcheck.zip b/bins/linkcheck.zip new file mode 100644 index 0000000..8d58998 Binary files /dev/null and b/bins/linkcheck.zip differ diff --git a/bins/mdbook b/bins/mdbook new file mode 100755 index 0000000..df7a9b2 Binary files /dev/null and b/bins/mdbook differ diff --git a/bins/mdbook-linkcheck b/bins/mdbook-linkcheck new file mode 100644 index 0000000..36e9243 Binary files /dev/null and b/bins/mdbook-linkcheck differ diff --git a/grammar/book/.nojekyll b/grammar/book/.nojekyll new file mode 100644 index 0000000..f173110 --- /dev/null +++ b/grammar/book/.nojekyll @@ -0,0 +1 @@ +This file makes sure that Github Pages doesn't process mdBook's output. diff --git a/grammar/book/404.html b/grammar/book/404.html new file mode 100644 index 0000000..71fc911 --- /dev/null +++ b/grammar/book/404.html @@ -0,0 +1,167 @@ + + +
+ + +This URL is invalid, sorry. Please use the navigation bar or search to continue.
+ +FORM | GLOSS | GRAMMEME |
---|---|---|
∅ | CC | Current Clause |
m / n / ŋ | INJ | Injective |
ʎï | COINJ | Coinjective |
θa | OC | Outer Clause |
ʎo | MC | Medial Connective |
ñï | SOP | Start Of Parenthetical |
ñaʼ | EOP | End Of Parenthetical |
█ | CLINJ | Clausal Injective |
FORM | GLOSS | GRAMMEME |
---|---|---|
aı | ASR | Assertive + unspecified evientiality |
oı | MEV | Multievidential |
a | INF | Inferential |
ı | SEN | Sensorial |
eo | ITU | Intuitive |
u | REC⁓RCL | Recollective |
ıwa | RCD | Recordative |
o | REP | Reportive |
ao | TWR | Trustworthy Reportive |
eı | UTR | Untrustworty Reportive |
e | EPI | Epistemic |
aya | AXM | Axiomatic |
FORM | GLOSS | GRAMMEME |
---|---|---|
ï | PFM | Performative |
ma | VRF | Verificative |
mu | PQ⁓PI | Polar Question, Polar Interrogative |
mı | CQ⁓CI | Content Question, Content Interrogative |
mu | RPQ⁓RPI | Rhetorical Polar Interrogative |
mı | RCQ⁓RCI | Rhetorical Content Interrogative |
kʰa | DIR | Directive |
kʰo | PET | Petitive |
kʰu | REQ | Requestive |
kʰe | SOL | Solicitive |
kʰı | OBLT | Oblative |
kʰao | RCM | Recommandative |
yao | PS | Permission-seeking |
FORM | GLOSS | GRAMMEME |
---|---|---|
t / a | UC1⁓INTR | Unary Case #1, Intransitive |
c / ı | BC1⁓ERG | Binary Case #1, Ergative |
k / u | BC2⁓ACC | Binary Case #2, Accusative |
p / e | TC1⁓TERG | Ternary Case #1, Ternary Ergative |
č / ï | TC2⁓CACC | Ternary Case #2, Coaccusative |
q / o | TC3⁓TACC | Ternary Case #3, Ternary Accusative |
pʰ / aʼa | QC1 | Quaternary Case #1 |
cʰ / eʼe | QC2 | Quaternary Case #2 |
čʰ / ïʼï | QC3 | Quaternary Case #3 |
qʰ / oʼo | QC4 | Quaternary Case #4 |
tʼ / uʼa | DP | Dislocated Predicate, Dislocative |
kʼ / aı | EXT⁓AFX | Extensional, Affixal |
š / aï | EV | Eventive |
tʰ / uʼı | SIT | Situative |
FORM | GLOSS | GRAMMEME |
---|---|---|
r | TOP | Topical |
ƛ | PND | Pendent |
ƛʼ / ıʼa | INS | Instrumental |
s / eı | LOC⁓SPL | Spatiotemporal Locative |
y | ITJ | Interjective |
w | VOC | Vocative |
n | PU | Plural Union |
ŋ | SEQ | Sequential |
l | MOD | Modificative |
ł | PRP | Propositional |
qʼ | DSIT | Discourse Situative |
FORM | GLOSS | GRAMMEME |
---|---|---|
eo | RCS | Relative Clause Subordinator |
ao | PCCS | Plain Content Clause Subordinator |
ea | PCCS | Polar Content Clause Subordinator |
oı | UTCS1 | Unary Template Clause Subordinator 1 |
██ | UTCS2 | Unary Template Clause Subordinator 2 |
oa | BTCS | Binary Template Clause Subordinator |
ı’ı | TTCS | Ternary Template Clause Subordinator |
u’u | QTCS | Quaternary Template Clause Subordinator |
FORM | GLOSS | GRAMMEME |
---|---|---|
aw | EF⁓ELU | Elucidative focus |
ay | BG | Background/Presupposition marker |
oy | PROP | Abstract property |
ew | CUQ | Collective universal quantifier |
ıw | ∀ | Distributive universal quantifier |
uy | ∃ | Existential quantifier |
ey | UQZ | Unary quantifierizer |
FORM | GLOSS | GRAMMEME |
---|---|---|
hu | COO | Coordinative |
ña | EAPCZ | ERG-ACC propositional conjunctionizer |
ñu | AEPCZ | ACC-ERG propositional conjunctionizer |
ñaı | EAECZ | ERG-ACC eventive conjunctionizer |
ñao | AEECZ | ACC-ERG eventive conjunctionizer |
ʎa | EAQZ | ERG-ACC binary quantifierizer |
ʎu | AEQZ | ACC-ERG binary quantifierizer |
ʎaı | ATR | Afterthought relativizer |
FORM | GLOSS | GRAMMEME |
---|---|---|
pʰa | EONQ | End of native quote |
qʼwaı | EOFQ | End of foreign quote |
ne | EOT | End of transmission |
e | ACK | Acknowledgement |
FORM | GLOSS | GRAMMEME |
---|---|---|
█ | PUI | Plural union initiator |
█ | SI | Set initiator |
█ | LI | List initiator |
█ | SWQI | Single-word quote initiator |
pʰaı | MWQI | Multi-word quote initiator |
█ | SWNI | Single-word name initiator |
ñaı | MWNI | Multi-word name initiator |
qʼwaı | FQI | Foreign quote initiator |
Nahaıwa, also known as Haıwa or NLL1 (acronym for ⟪Ntsékees' Logical Language #1⟫) is a prototype of a constructed monosemic language, i.e. a loglang: syntactic ambiguities are disallowed, as well as word polysemy and homonymy not resolvable through syntax alone, as well as opaque idiomatic expressions not explicitly marked as such. It is also an artlang, inasmuch as aesthetics (in the eyes of the author) is taken into account.
+It is currently in a developmental stage of prototype, and the description given here may be obsoleted by future changes to the language. The development of the language started in mid 2016.
+The language exhibits ‘scopal polysynthesis’, i.e. words may contain an arbitrary number of recursively stacked affixes —in this case, prefixes— with transparent meanings, called “extensional prefixes”. Its morphology is purely prefixal, of agglutinative nature with some portmanteau morphemes. There are three main lexically-assigned categories of lexical units:
+• contentives (which may assume the syntactic roles of verb, noun, participle, adjective, adverb, conjunction or quantifier, depending on the way they are inflected);
+• inflecting functors / functional words (these have exactly the same morphology as contentives, but have special effects on the surrounding syntax);
+• uninflected functors, i.e. particles.
Functors are closed classes, and they have a fairly small number of members.
+The vocabulary is a priori, not derived or borrowed from that of existing natural or constructed languages.
+The consonant inventory is large (36 consonants), and mainly inspired by the inventories of Athabascan languages, as well as Aymara and Quechua languages.
+ +