diff --git a/assets/javascripts/templates/pages/help_tmpl.coffee b/assets/javascripts/templates/pages/help_tmpl.coffee index ec18d134..3f09a9ce 100644 --- a/assets/javascripts/templates/pages/help_tmpl.coffee +++ b/assets/javascripts/templates/pages/help_tmpl.coffee @@ -1,47 +1,68 @@ -ctrlKey = if $.isMac() then 'cmd' else 'ctrl' -navKey = if $.isMac() then 'cmd' else 'alt' +app.templates.helpPage = -> + ctrlKey = if $.isMac() then 'cmd' else 'ctrl' + navKey = if $.isMac() then 'cmd' else 'alt' -app.templates.helpPage = """ + aliases_one = {} + aliases_two = {} + keys = Object.keys(app.models.Entry.ALIASES) + middle = Math.ceil(keys.length / 2) - 1 + for key, i in keys + (if i > middle then aliases_two else aliases_one)[key] = app.models.Entry.ALIASES[key] + + """ -
+ Documentations can be enabled and disabled in the Preferences. + Alternatively, you can enable a documentation by searching for it in the main search + and clicking the "Enable" link in the results. + For faster and better search, only enable the documentations you plan on actively using. +
+ Once a documentation is enabled, it becomes part of the search and its content can be downloaded for offline access — and faster page loads when online — in the Offline area.
- The search is case-insensitive. It supports fuzzy matching
+ The search is case-insensitive and ignores whitespace. It supports fuzzy matching
(e.g. bgcp
matches background-clip
)
- and aliases (full list below).
+ as well as aliases (full list below).
Tab
(Space
on mobile devices).
+ The search can be scoped to a single documentation by typing its name (or an abbreviation)
+ and pressing tab
(space
on mobile).
For example, to search the JavaScript documentation, enter javascript
- or js
, then Tab
.Backspace
.
+ or js
, then tab
.backspace
or
+ esc
.
#q=
will be used as search query.Tab
when devdocs.io is autocompleted
+ tab
when devdocs.io is autocompleted
in the omnibox (to set a custom keyword, click Manage search engines\u2026 in Chrome's settings).
+ Note: the above search features only work for documentations that are enabled.
ctrl + ,
escape
- esc
+ ?
Word - | Alias - #{(" |
---|---|
#{key} | #{value}" for key, value of app.models.Entry.ALIASES).join('')} - |
Word + | Alias + #{(" |
---|---|
#{key} | #{value}" for key, value of aliases_one).join('')} + |
Word + | Alias + #{(" |
---|---|
#{key} | #{value}" for key, value of aliases_two).join('')} + |
Feel free to suggest new aliases on GitHub. """ diff --git a/assets/javascripts/views/content/static_page.coffee b/assets/javascripts/views/content/static_page.coffee index 70489bc3..d7bee725 100644 --- a/assets/javascripts/views/content/static_page.coffee +++ b/assets/javascripts/views/content/static_page.coffee @@ -4,7 +4,7 @@ class app.views.StaticPage extends app.View @titles: about: 'About' news: 'News' - help: 'Help' + help: 'User Guide' notFound: '404' deactivate: -> diff --git a/assets/stylesheets/components/_content.scss b/assets/stylesheets/components/_content.scss index bb86cc2f..9b8e299a 100644 --- a/assets/stylesheets/components/_content.scss +++ b/assets/stylesheets/components/_content.scss @@ -354,6 +354,20 @@ @extend %label; } +// +// Search aliases +// + +._aliases { + display: flex; + justify-content: space-between; + + > table { + margin-top: 0; + width: calc(50% - 0.5rem); + } +} + // // Utilities // diff --git a/views/app.erb b/views/app.erb index b5803b6f..7cffabd0 100644 --- a/views/app.erb +++ b/views/app.erb @@ -23,7 +23,7 @@ Preferences Offline Data Changelog - Help + Guide About