mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-06-14 11:52:32 +03:00
Added built files + documentation
This commit is contained in:
parent
c32c7a8a20
commit
29a34d19a8
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
2
material/assets/javascripts/packer.js
Normal file
2
material/assets/javascripts/packer.js
Normal file
File diff suppressed because one or more lines are too long
1
material/assets/javascripts/packer.js.map
Normal file
1
material/assets/javascripts/packer.js.map
Normal file
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
2
material/assets/stylesheets/app.min.css
vendored
2
material/assets/stylesheets/app.min.css
vendored
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@ -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 %}
|
||||
|
@ -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(
|
||||
|
@ -31,7 +31,7 @@ import { renderSectionDocument } from "../section"
|
||||
* ------------------------------------------------------------------------- */
|
||||
|
||||
/**
|
||||
* CSS class references
|
||||
* CSS classes
|
||||
*/
|
||||
const css = {
|
||||
item: "md-search-result__item"
|
||||
|
@ -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>
|
||||
)
|
||||
|
@ -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>
|
||||
)
|
||||
|
@ -21,4 +21,5 @@
|
||||
*/
|
||||
|
||||
export * from "./agent"
|
||||
export * from "./string"
|
||||
export * from "./toggle"
|
||||
|
42
src/assets/javascripts/utilities/string/index.ts
Normal file
42
src/assets/javascripts/utilities/string/index.ts
Normal 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
|
||||
}
|
@ -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,
|
||||
|
Loading…
Reference in New Issue
Block a user