215611aa9e
refactor(aio): rename auto-scroll -> scroll and refactor
...
Refactor inspired by @gkalpak feedback on PR #16619
2017-05-09 14:11:23 +01:00
98d83b2e2d
feat(aio): scroll back to top when TOC more-items clicked to close
...
closes #16482
Usability feature. When long embedded TOC, collapsing it should scroll user to TOC top, not leave in the middle of the page.
2017-05-09 14:11:23 +01:00
cf7689ea7b
refactor(aio): simplify/clarify some observables
2017-05-09 14:10:58 +01:00
2848f0499f
fix(aio): do not nav to an image url
...
closes #16608
Formerly, tried to navigate when user clicked an anchor with an image url (to view image in a new tab) resulting in 404.
Now ignores href URL with any extension and lets browser handle it.
2017-05-09 14:10:36 +01:00
3887d8a429
feat(aio): close sidenav in narrow (mobile) mode when select a new document ( #16617 )
...
closes #16603
As before this PR, when wide (side-by-side), the sidenav open/close status only changes when nav to/from marketing page in which case it opens for guide/api and closes for marketing page.
2017-05-08 15:41:19 -07:00
041f57cb7d
feat(aio): focus search when `/` is pressed ( #16636 )
...
This will aid accessibility.
Closes #16129
2017-05-08 15:40:32 -07:00
98dd609f89
docs(animations): remove duplicate word ( #16508 )
2017-05-08 10:47:13 -07:00
6dc67772b0
docs(aio): move links from nav groups to items
...
Fundamentals and Techniques nav groups we also links to pages. This caused
counterintuitive behaviour when clicking on them.
This commit moves each link from the group item to a children item, called
Introduction.
Closes #16604
2017-05-07 08:14:10 +01:00
5cf64266f8
docs(aio): fix sizing of marketing doc images
...
This commit ensures that all the images in the marketing docs are correcly
sized.
Related to #16600
2017-05-06 14:35:24 +01:00
03513e9d70
fix(aio): constrain header-link styles
...
The CSS rule for positioning the automated header links was too general,
causing other links inside headings to be positioned incorrectly.
Closes #16573
2017-05-06 14:32:49 +01:00
b9ed97c0d9
fix(aio): do not display a Toc initially
...
Previously the `hasToc` was initialised to true, which caused a flash of
unwanted "Contents" [sic] even if the page was not going to need a ToC.
Closes #16597
2017-05-06 14:32:09 +01:00
799be9c98a
feat(aio): TOC float right + service refactor
...
TOC appears in right panel when wide and hides embedded TOC
Right TOC panel height adjusts dynamically during scroll
Refactored `TocService` and its tests for clarity.
2017-05-06 07:13:31 +01:00
566dab1140
build(aio): upgrade to @angular/service-worker@1.0.0-beta.11 ( #16594 )
2017-05-05 16:16:55 -07:00
42dc2c19ee
refactor(aio): remove redundant test
...
The search worker is now initialised from the `SearchBoxComponent`, which
has its own tests for this.
Closes #15593
2017-05-05 13:43:02 -07:00
518eb540aa
refactor(aio): tweak the CSS to account for new CSS classes on `aio-shell`
2017-05-05 13:42:34 -07:00
309ada5df5
feat(aio): add helper CSS classes to the `aio-shell` for fine grained styling
...
Alternative to #16564
Closes #16549
2017-05-05 13:42:34 -07:00
2714644528
docs(aio): fix broken links discovered May 4th
2017-05-05 11:05:22 +01:00
d27588b5fb
feat(aio): api label styles
...
- Moved info bar section in pipe template to be the first section to match other templates
- Fixed label styling for type label
- Added label styling for status label
2017-05-05 11:04:55 +01:00
a8379a46cf
docs(aio): remove toc from all marketing pages
2017-05-05 10:43:36 +01:00
b7caa3e024
fix(aio): do not route `eplnkr` URLs to / from ServiceWorker
2017-05-05 10:42:58 +01:00
3e33482386
feat(aio): should not send in-page navigations to Google Analytics
...
closes #16521
`LocationService` sends `GaService` a url stripped of fragment and query strings.
`GaService` already guards against re-send of the prior url so it will only report doc changes.
2017-05-05 10:37:36 +01:00
5057e16874
build(aio): throw an error if a code-example tag is not closed
2017-05-04 15:52:17 -07:00
9449eff6fd
docs(aio): improve tutorial next-steps prose/links
2017-05-04 15:51:57 -07:00
03610526e5
docs(aio): remove hardcoded TOC
2017-05-04 15:51:37 -07:00
8931e71c5c
build(aio): ensure that tutorial index arrives in the tutorial search area
...
Fixes #16457
2017-05-04 13:45:04 +01:00
5bc435eba3
feat(aio): provide icon for API packages in search
2017-05-04 13:45:04 +01:00
4dabec6a48
build(aio): compute search title for certain API docs
2017-05-04 13:45:04 +01:00
978376a46e
build(aio): `doc.searchTitle` can override name in search results
2017-05-04 13:45:04 +01:00
895f47a9c2
refactor(aio): remove work-around for browsers without ServiceWorker support
...
This essentially reverts #15731 , which is no longer necessary after
angular/mobile-toolkit@eeb4b22 (which is included in v1.0.0-beta.10).
2017-05-04 12:28:19 +01:00
aec65dee71
refactor(aio): simplify DocViewer
2017-05-04 12:23:49 +01:00
2f66932bd1
fix(aio): make `aio-top-menu .nav-link` cover the whole `<li>`
...
Discussed in https://github.com/angular/angular/pull/16513/files#r114630560 .
2017-05-03 19:34:58 -07:00
919ff12377
fix(aio): cheatsheet table layout fix
2017-05-03 19:34:12 -07:00
6748aeabb6
build(aio): update to dgeni-packages 0.19.0
...
This contains an updated dependency to TypeScript 2.1, which supports the
language constructs that we are using in Angular.
2017-05-03 19:33:58 -07:00
77b8a76f2e
feat(aio): toc styling
...
- TOC styling
- TOC container placeholder
2017-05-03 19:32:41 -07:00
55b8de9fdd
build(aio): lint examples
2017-05-03 13:44:41 -07:00
eb56ab38dc
fix(aio): remove top bar menu item focus jump
2017-05-03 13:43:42 -07:00
f29c6bbc6f
docs(aio): fix missing title warnings
...
This commit provides missing titles for Press kit.
License appears not to want a title.
ngmodule and resources2 are no longer needed.
2017-05-03 13:42:10 -07:00
464701a899
docs(aio): revert removal of tutorial examples
...
These files were inadvertently removed in #16488 but are actually still referenced.
Closes #16503
2017-05-03 13:41:05 -07:00
5b96fb9320
build(aio): rename `src/content` to `src/generated`
...
This commit will definitely require a clean up of your
working folder:
```
cd aio
git clean -xdf
yarn setup
```
2017-05-03 13:40:46 -07:00
1cfb263ee3
docs(aio): hide the copy button for code in StyleGuide tables.
2017-05-03 13:38:25 -07:00
9ca2b4c967
feat(aio): set “avoid” class by convention (filename has “.avoid.”)
...
Most important for StyleGuide which lost example css class in migration.
Also hides copy for “avoid” files.
2017-05-03 13:30:45 -07:00
673d8ae583
feat(aio): add attribute utils for code atty interpretation.
...
These utils support flexible, natural attribute interpretation as applied to code-example and code-pane. Then apply those utils to code-example and live-example
2017-05-03 13:30:45 -07:00
8760bf7be4
build(aio): fix paths to template macros in overview-dump template
2017-05-03 13:30:11 -07:00
ea02073c84
build(aio): mark API docs as not having a TOC
2017-05-03 13:30:11 -07:00
b051d7ff48
build(aio): refactor API templates for clean start
2017-05-03 13:30:11 -07:00
cade722e48
build(aio): upgrade to dgeni-packages@0.18.0
...
This contains a fix for the typescript module reader.
Previously, TS modules that were of the form:
```
a/b/index.ts
```
Would be given the name `index` and id of `a/b/index`.
This is not desirable, so the new version of dgeni-packages/typescript
removes this `index` from the id and name, which results in name of
`b` and id of `a/b`.
2017-05-03 13:30:11 -07:00
58817f55e1
fix(aio): do not collapse API code example indentation
2017-05-03 13:30:11 -07:00
3f1d7f7a76
build(aio): add the api folder to the list of template folders
2017-05-03 13:30:11 -07:00
c8dc116951
docs(aio): fixing new url on glossary date pipe
2017-05-03 13:29:04 -07:00
5ba8c14893
docs(aio): remove unnecessary anchor links from styleguide
2017-05-03 09:21:18 +01:00
ea9d8a6bc7
docs(aio): move pipes guide under components
2017-05-03 09:01:05 +01:00
9650ff0824
docs(aio): add hero “Zero” to toh-6
...
Update to in-memory-web-api should handle id=0.
Make sure this works by having a hero with id=0 in ToH.
Coincidentally delete lingering dead app/ folders
Todo: fix ToH images (which have to do anyway)
2017-05-03 08:03:55 +01:00
00dce1698a
docs(aio): grammatical fix. remove duplicate word 'our'
2017-05-03 08:03:03 +01:00
21c96a5af1
feat(aio): sidenav styling extended
2017-05-02 15:14:21 -07:00
a0b9c23100
feat(aio): support hiding the copy button on `code-examole` components
...
In the API docs there are occasions where we do not wish the code snippet
to have a copy button. This commit supports that by providing a new `hideCopy`
attribute.
2017-05-02 15:14:03 -07:00
cb5bc76766
feat(aio): move search results under search box
...
This enables keyboarders to tab from the search box into the results.
Important for a11y according to issue #16005 .
2017-05-02 15:13:40 -07:00
1c8772a879
fix(aio): delete guide/index.md which is no longer used
2017-05-02 15:13:15 -07:00
79ed0e7121
feat(aio): display API icons in search results
...
Add API symbols for `let` and `var` so don’t have to translate those types into `const`
Also replace <hr> in search results HTML with ellipses icon.
2017-05-02 15:12:58 -07:00
0c69903123
feat(aio): top 5 weighted search results shown when many area results
2017-05-02 15:12:58 -07:00
04dc24820d
feat(aio): comment cleanup, API table styles
...
- API table styling
- Cleanup on resource page comments
2017-05-02 10:57:54 -07:00
ac220fc2bb
docs(aio): fix image size on homepage
2017-05-01 15:52:51 -07:00
3b80472bad
style(aio): fix comment on postProcessHtml processor
...
Fixes https://github.com/angular/angular/pull/16336#discussion_r113891332
2017-05-01 15:52:51 -07:00
ca17d4f639
build(aio): auto-fill width/height to all image tags
...
Parse all `<img>` tags, during doc-gen, and insert the width and height of
the sourceed image, if neither are already specified.
Warnings are reported if the `<img>` tag has no `src` attribute or the image
cannot be loaded.
The work is done in the `addImageDimensions` post-processor, which must be
configured with a `basePath` so that it knows where to find the images.
Closes #15888
2017-05-01 15:52:51 -07:00
64335d3521
build(aio): capture and log errors and warnings when post-processing HTML
2017-05-01 15:52:51 -07:00
9945ce2259
build(aio): move copyContentAssets processor to the base package
...
This allows other processors who need to know about the copyContentAssets
processors to ensure that the runs after the content has been copied.
2017-05-01 15:52:51 -07:00
6d9da73090
build(aio): move attribute utils to helpers folder
...
This allows these utility functions to be reused across packages.
2017-05-01 15:52:51 -07:00
c889fb1ef5
build(aio): include new packages in docs-watch
2017-05-01 15:52:51 -07:00
d32bc5df3e
feat(aio): add tooltip to nav node if none specified
2017-05-01 15:52:35 -07:00
efaf502e95
feat(aio): tell user when no search results
...
closes #16294
2017-05-01 15:51:44 -07:00
ff32c53099
docs(aio): fix lots of broken links
...
Closes #16317
2017-05-01 15:51:26 -07:00
235eb17cca
build(aio): improve info-bar template
...
The "npm module" and "NgModule" are now rendered correctly.
Closes #16055
2017-05-01 15:51:03 -07:00
aaa562898f
fix(aio): correct position of sidenav icons
2017-05-01 15:50:34 -07:00
c8fd904c32
fix(aio): remove max width on marketing pages and footer
...
- Removed the max-width on all marketing pages
- Moved the footer so that it extends fully horizontally on all screen sizes
2017-05-01 15:50:17 -07:00
65a8f7f6c9
fix(aio): search result styling
...
- Changed search result link hover state to white to be more legible
- Increased the max-height on search results container to remove the jitter
- Changed search results to have space-around vs space-between for more appropriate spacing
2017-05-01 15:49:46 -07:00
f32bfcdbe5
build(aio): convert triple backtick blocks to `code-example` tags
...
Closes #16246
2017-04-30 09:07:28 -07:00
24b9067047
build(aio): remove unused `{@exampleTabs}` inline tag
2017-04-30 09:07:28 -07:00
de8de84cea
test(aio): confirm ga tracks user’s # fragment clicks within a page ( #16441 )
...
This was the behavior and we think we still want to do it.
Added comment and test to confirm that is our present intention.
2017-04-30 09:07:12 -07:00
8d300ffbfc
fix(aio): header click should always toggle expand/collapse ( #16439 )
...
Also adds class tests for this NavItemComponent.
Not (yet) testing effects on the templated HTML
2017-04-30 09:07:00 -07:00
f74dafcb07
docs(aio): Add numbers and steps to Tutorial navigation ( #16421 )
2017-04-30 09:06:36 -07:00
a2b2afb21c
feat(aio): add marketing class to AppComponent <aio-shell> on mkt page ( #16395 )
...
Also navigation.json Doc page should be hidden in sidebar, shown in top
2017-04-28 15:34:20 -07:00
b70b9606eb
docs(aio): apply guidelines to ts-to-js - adapt for aio site ( #16054 )
2017-04-28 15:34:00 -07:00
938406122e
docs(aio): add missing word ( #16328 )
2017-04-28 15:33:23 -07:00
951a575db3
docs(aio): fix broken NgModules link in tutorial ( #16398 )
...
Brackets included in link title contents were breaking markdown
parsing, preventing correct link generation.
2017-04-28 15:32:46 -07:00
c04e51cb15
fix(aio): do not create ToC for `file-not-found` and `fetching-error` documents
...
Related to #16078 .
2017-04-28 15:06:05 +01:00
7b94f493b9
feat(aio): code snippet source available & shown when code missing
...
Tells reader (usually the author) what code file is missing
Also when no linenums specified, turn them on if num of lines > 10
2017-04-28 11:07:45 +01:00
f1f04fa782
feat(aio): implement gkalpak review suggestions
2017-04-28 09:45:09 +01:00
4be1966a21
feat(aio): revise Docs page; docs version selector in sidenav
2017-04-28 09:40:39 +01:00
de25cfc0cb
build(aio): move autolink-headings to post-processing ( #16336 )
...
The autolinking is now done on the `renderedContent` which means it also
captures and autolinks headings that were generated outside of markdown.
PR Close #16336
2017-04-27 23:42:04 -05:00
de36a9b718
fix(aio): improve positioning of heading-anchors
2017-04-27 23:42:04 -05:00
883a3250e4
fix(aio): ensure styling of icons is specific to usage
...
Previously the CSS styling for material icons was too broad and affected
all instances of icons. This commit constrains the position of copy button
icons only to copy buttons.
2017-04-27 23:42:04 -05:00
1ceb2f9c79
build(aio): add new post-process dgeni package
...
This package will allow us to do complex post-processing
on the HTML that is rendered by Nunjucks.
2017-04-27 23:42:04 -05:00
fbde2a8010
docs(aio): correct abbreviation ( #16295 )
...
change abbreviation from 'ES' to 'ES2015'. the 'ES2015' abbreviation is used elsewhere in the tutorial.
2017-04-27 21:39:46 -07:00
3f46645f5f
feat(aio): add Table of Contents (toc) component. ( #16078 )
2017-04-27 15:32:46 -07:00
2a7f63650c
build(aio): update @angular/service-worker to v1.0.0-beta.10
2017-04-27 10:14:32 +01:00
cd5b1f306a
refactor(aio): move `/guide/docs.md` to `/marketing/docs.md`
...
Because:
1. `docs` feels like a "top level" page, similar to `features`, `resources`, `events` etc.
2. This enables the ServiceWorker to pre-fetch/cache the document (similar to what happens with all
other direct children of `content/docs/`), without the need for special-casing it in
`ngsw-manifest.json`.
2017-04-27 10:14:32 +01:00
749bcf3d9c
feat(aio): cache external resources in the ServiceWorker
...
Cache resources that are necessary for displaying the basic pages when offline.
2017-04-27 10:14:32 +01:00
a9027a2570
fix(aio): fix ServiceWorker routing
2017-04-27 10:14:32 +01:00
72e32b1f17
fix(aio): update files ignored by the ServiceWorker
...
Fixes #16198
2017-04-27 10:14:32 +01:00
96648ba98a
fix(aio): fix incorrect image URLs in guides
2017-04-27 10:14:32 +01:00
6561d46349
refactor(aio): move content-related images to `content/images/`
2017-04-27 10:14:32 +01:00
Ward Bell
Pete Bacon Darwin
Jason Hodges
Stefanie Fluin
Alex Rickabaugh
Georgios Kalpakas
Jesús Rodríguez
aravindfz
Souvik Basu
Kapunahele Wong
Will Howell
Kim Burgess
swseverance