1
0
mirror of https://github.com/squidfunk/mkdocs-material.git synced 2024-09-23 19:08:25 +02:00

Added built files + documentation

This commit is contained in:
squidfunk 2019-12-18 17:14:20 +01:00
parent c32c7a8a20
commit 29a34d19a8
16 changed files with 216 additions and 43 deletions

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

File diff suppressed because one or more lines are too long

View File

@ -122,8 +122,8 @@
{% if feature.tabs %}
{% include "partials/tabs.html" %}
{% endif %}
<main class="md-main" role="main">
<div class="md-main__inner md-grid" data-md-component="main">
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
{% block site_nav %}
{% if nav %}
<div class="md-sidebar md-sidebar--primary" data-md-component="navigation">
@ -235,7 +235,7 @@
{%- endfor -%}
{{ translations | tojson }}
</script>
<script>app=initialize({base:"{{ base_url }}",search:"{{ 'assets/javascripts/search.js' | url }}"})</script>
<script>app=initialize({base:"{{ base_url }}",worker:{search:"{{ 'assets/javascripts/search.js' | url }}",packer:"{{ 'assets/javascripts/packer.js' | url }}"}})</script>
{% for path in config["extra_javascript"] %}
<script src="{{ path | url }}"></script>
{% endfor %}

View File

@ -22,18 +22,16 @@
import { identity } from "ramda"
import {
EMPTY,
MonoTypeOperatorFunction,
NEVER,
Observable,
Subject,
fromEvent,
merge,
of,
pipe,
zip
} from "rxjs"
import {
delay,
distinctUntilKeyChanged,
filter,
map,
pluck,
@ -41,12 +39,9 @@ import {
switchMap,
switchMapTo,
tap,
withLatestFrom
} from "rxjs/operators"
import { ajax } from "rxjs/ajax"
import { Config, isConfig } from "./config"
import { setupSearch } from "./search"
import {
Component,
paintHeaderShadow,
@ -59,23 +54,57 @@ import {
watchMain,
watchSearchReset,
watchSidebar,
watchToggle,
watchTopOffset
} from "./theme"
} from "./components"
import {
not,
switchMapIf
} from "./extensions"
import { SearchIndex } from "./modules/search"
import {
getElement,
watchDocument,
watchDocumentSwitch,
watchLocation,
watchLocationFragment,
watchMedia,
watchToggle,
watchViewportOffset,
watchViewportSize
} from "./ui"
import {
getElement,
not,
switchMapIf
watchViewportSize,
watchWorker
} from "./utilities"
import { SearchMessage, SearchMessageType } from "./workers"
/**
* Configuration
*/
export interface Config {
base: string /* Base URL */
worker: {
search: string /* Web worker URL */
packer: string /* Web worker URL */
}
}
import { PackerMessage, PackerMessageType } from "./workers/packer"
import { renderSearchResult } from "./templates"
/* ----------------------------------------------------------------------------
* Functions
* ------------------------------------------------------------------------- */
/**
* Ensure that the given value is a valid configuration
*
* @param config - Configuration
*
* @return Test result
*/
export function isConfig(config: any): config is Config {
return typeof config === "object"
&& typeof config.base === "string"
}
// TBD
@ -112,6 +141,72 @@ export function initialize(config: unknown) {
if (!isConfig(config))
throw new SyntaxError(`Invalid configuration: ${JSON.stringify(config)}`)
const worker = new Worker(config.worker.search)
const packer = new Worker(config.worker.packer)
// const query = message.data.trim().replace(/\s+|$/g, "* ") // TODO: do this outside of the worker
const packerMessage$ = new Subject<PackerMessage>()
const packer$ = watchWorker(packer, { message$: packerMessage$ })
// send a message, then switchMapTo worker!
packer$.subscribe(message => {
console.log("PACKER.MSG", message)
// is always packed!
console.log(message.data.length)
localStorage.setItem("index", message.data)
})
const searchMessage$ = new Subject<SearchMessage>()
const search$ = watchWorker(worker, { message$: searchMessage$ })
search$.subscribe(message => {
if (message.type === SearchMessageType.DUMP) {
console.log(message.data.length)
packerMessage$.next({
type: PackerMessageType.STRING,
data: message.data
})
} else if (message.type === SearchMessageType.RESULT) {
console.log("RESULT", message)
const list = document.querySelector(".md-search-result__list")!
list.innerHTML = ""
for (const el of message.data.map(renderSearchResult)) // TODO: perform entire lazy render!!!!
list.appendChild(el as any) // only render visibile stuff...!
// paint on next animation frame!?
// build a rendering pipeline for search results + scroll bottom!
}
// if (message.type === 0) {
// console.log("Packing...")
// packerMessage$.next(message.toString())
// } else {
// console.log((message as any).term, ":", (message as any).res)
// }
})
// filter singular "+" or "-",as it will result in a lunr.js error
ajax({
url: `${config.base}/search/search_index.json`,
responseType: "json",
withCredentials: true
})
.pipe(
pluck("response"),
map<SearchIndex, SearchMessage>(data => ({
type: SearchMessageType.SETUP,
data
}))
)
.subscribe(message => {
searchMessage$.next(message) // TODO: this shall not complete
})
/* ----------------------------------------------------------------------- */
/* Create viewport observables */
@ -133,7 +228,7 @@ export function initialize(config: unknown) {
/* ----------------------------------------------------------------------- */
/* Create component map observable */
const components$ = watchComponentMap(names, { load$ })
const components$ = watchComponentMap(names, { document$: load$ })
const component = (name: Component): Observable<HTMLElement> => {
return components$
@ -157,6 +252,22 @@ export function initialize(config: unknown) {
// ----------------------------------------------------------------------------
component("query")
.pipe(
switchMap(el => fromEvent(el, "keyup") // not super nice...
.pipe(
map<Event, SearchMessage>(() => ({
type: SearchMessageType.QUERY,
data: (el as HTMLInputElement).value
})), // TODO. ugly...
distinctUntilKeyChanged("data")
)
)
)
.subscribe(x => {
searchMessage$.next(x)
})
// // WIP: instant loading
// load$
// .pipe(

View File

@ -31,7 +31,7 @@ import { renderSectionDocument } from "../section"
* ------------------------------------------------------------------------- */
/**
* CSS class references
* CSS classes
*/
const css = {
item: "md-search-result__item"

View File

@ -22,13 +22,14 @@
import { h } from "extensions"
import { ArticleDocument } from "modules"
import { truncate } from "utilities"
/* ----------------------------------------------------------------------------
* Data
* ------------------------------------------------------------------------- */
/**
* CSS class references
* CSS classes
*/
const css = {
link: "md-search-result__link",
@ -55,7 +56,10 @@ export function renderArticleDocument(
<a href={location} title={title} class={css.link} tabIndex={-1}>
<article class={css.article}>
<h1 class={css.title}>{title}</h1>
{text.length ? <p class={css.teaser}>{text}</p> : undefined}
{text.length
? <p class={css.teaser}>{truncate(text, 320)}</p>
: undefined
}
</article>
</a>
)

View File

@ -22,13 +22,14 @@
import { h } from "extensions"
import { SectionDocument } from "modules"
import { truncate } from "utilities"
/* ----------------------------------------------------------------------------
* Data
* ------------------------------------------------------------------------- */
/**
* CSS class references
* CSS classes
*/
const css = {
link: "md-search-result__link",
@ -55,7 +56,10 @@ export function renderSectionDocument(
<a href={location} title={title} class={css.link} tabIndex={-1}>
<article class={css.article}>
<h1 class={css.title}>{title}</h1>
{text.length ? <p class={css.teaser}>{text}</p> : undefined}
{text.length
? <p class={css.teaser}>{truncate(text, 320)}</p>
: undefined
}
</article>
</a>
)

View File

@ -21,4 +21,5 @@
*/
export * from "./agent"
export * from "./string"
export * from "./toggle"

View File

@ -0,0 +1,42 @@
/*
* Copyright (c) 2016-2019 Martin Donath <martin.donath@squidfunk.com>
*
* 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 NON-INFRINGEMENT. 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.
*/
/* ----------------------------------------------------------------------------
* Functions
* ------------------------------------------------------------------------- */
/**
* Truncate a string after the given number of characters
*
* @param string - String to be truncated
* @param n - Number of characters
*
* @return Truncated string
*/
export function truncate(string: string, n: number): string {
let i = n
if (string.length > i) {
while (string[i] !== " " && --i > 0);
return `${string.substring(0, i)}...`
}
return string
}

View File

@ -1,7 +1,7 @@
{
"compilerOptions": {
"alwaysStrict": true,
"baseUrl": ".",
"baseUrl": "src/assets/javascripts",
"declaration": false,
"declarationMap": false,
"downlevelIteration": true,
@ -21,7 +21,15 @@
"noImplicitThis": true,
"noUnusedLocals": true,
"noUnusedParameters": true,
"paths": {},
"paths": {
"actions": ["actions"],
"components": ["components"],
"extensions": ["extensions"],
"modules": ["modules"],
"templates": ["templates"],
"utilities": ["utilities"],
"workers": ["workers"]
},
"removeComments": false,
"resolveJsonModule": true,
"sourceMap": true,