Commit Graph

77 Commits

Author SHA1 Message Date
Martin Taillefer d6b3bfac56
Add support for {{< quote >}} (#3237) 2019-02-12 08:22:28 -08:00
Martin Taillefer b3db41da99
Added more lint rules and fix offenders (#3227)
- Ensure that references to GitHub content use the proper annotations so
we get links to the correct branches.

- Added a check to make sure content is not using blockquotes (instead of
{{< warning >}}, {{< tip >}}, and {{< idea >}}. This check is currently
disabled, pending the Chinese content being updated.

- Fix a few violations of these new checks.
2019-02-11 12:49:47 -08:00
Martin Taillefer 2434af7761
Update reference docs. (#3204) 2019-02-06 20:39:46 -08:00
Vincent 4fd40a24c7 New option: Let linter ignore the external links (#3046)
* let linter ignore the external links

* fixed: typo
2019-01-07 09:58:44 -08:00
Martin Taillefer f17a5d2e79
Fix a bunch of absolute links that should have been relative. (#2933)
- Added a linter rule to prevent further occurances.
2018-11-30 06:41:56 -08:00
Martin Taillefer e4c547edc2
Use Hugo's errorf command instead of injecting magic error strings into the generated HTML. (#2922)
This produces better errors with source file & line info when shortcodes are misused by
markdown files.
2018-11-26 17:22:57 -08:00
Martin Taillefer 7c791bfc44 Add trulia.com to our exception list, since it is causing a lot of false positive lint failures. (#2864) 2018-11-12 13:44:00 -08:00
Martin Taillefer 28900ad96c
Improve spell checking command so we get colorized output. (#2752) 2018-10-08 22:31:10 -07:00
Martin Taillefer 3acfe3fe40
Replace references from istio.github.io to istio.io (#2686) 2018-09-25 12:13:38 -07:00
Jimmy Song 91d2481bc5 Delete special chars and turn on HTML checking (#2292)
* Delete special chars and turn on HTML checking

- Refer to #2289 and issue #2290
- Delete the special chars in Chinese content
- Turn on HTML checking to highlight problems

* delete the redundant period
2018-08-19 07:42:20 -07:00
Jimmy Song 0b2ea1d38e Enable extra lint stuff (#2158) 2018-08-06 09:43:31 -07:00
Martin Taillefer fd290dc73e
Improve linting (#2148)
- We now detect text blocks that are incorrectly indented.

- We now detect image captions that end in a period.

- We now detect page descriptions that don't end in a period.

- CircleCi now runs linting without minifying HTML first, improving perf and
improving error output.

- In CircleCi, we now have a per-build cache for HTML proofer output. This
helps reduce the frequency of link timeout errors.

- Fix errors flagged by the above new lint checks.
2018-08-04 08:44:06 -07:00
Jimmy Song 0492530216 Fix Chinese spelling errors (#2044)
* Chinese: about/contribute/github/index.md

- translate working with GitHub
- translate contributing to docs index

* Chinese: add two indexes for policy and telemetry

- add policy and telemetry index
- add adapters index

* modify translation

* Fix Chinese spelling errors

- enable Chinese spelling checks
- fix spelling errors
- refer to #2038
2018-07-30 04:34:54 -07:00
Martin Taillefer 1c300c99bd
Spelling improvements (#2037)
Remove a bunch of entries that shouldn't have been in the spelling dictionary
and correct content aoocrdingly.

I'm disabling the Chinese spell checking for now, since I'm not able to fix the
spelling errors that emerged there. Once this PR is in, I'll file an issue to get
those spelling errors addressed and checking reenabled.
2018-07-29 14:27:06 -07:00
Martin Taillefer 04cc4a3d84
Start populating the ops guide. (#1994) 2018-07-26 15:05:23 -07:00
mtail 3dee29d873 Fix a linting error. 2018-07-23 17:27:29 -07:00
Martin Taillefer 5527dcbaf6
Switch uses of funny quotation marks to plain ones. (#1914)
- Use only standard quotation marks to avoid cut & paste stuff not working

- Put in a lint rule to prevent further use of non-plain quotation marks.
2018-07-22 08:48:03 -07:00
Martin Taillefer 597f7ce3b4
Enable more linting rules (#1824)
Fix feported linting errors.
2018-07-15 07:49:11 -07:00
Martin Taillefer f4a0656ab1 Add a lint check for incorrectly indented code blocks. (#1800)
Fixed a problem reported by the link check.
2018-07-13 07:26:36 -07:00
Martin Taillefer 0541000be8
Switch from ``` to {{< text >}} to indicate text blocks. (#1644)
This fixes a number of cases of incorrect formatting of code blocks
throughout the site.
2018-06-30 07:11:21 -07:00
mtail fa0a3fe408 Turn htmlproofer back on. 2018-06-28 07:53:34 -07:00
Martin Taillefer 5a1b090fbc
Improve handling for code blocks (#1580)
- Add the {{< text >}} shortcode as a way to declare code blocks. This shortcode
is intended to hide the subtleties around code blocks. More specifically, it
provides a transparent workaround for the Hugo bug around converting indented
code blocks with lines starting with dashes. It also deals with the special
formatting case we have around command-lines that start with `cat <<EOF`.

- Rename the {{< file_content >}} shortcode to {{< text_file >}} and the
{{< fetch_content >}} shortcode to {{< text_dynamic >}} for consistency in naming.
2018-06-28 06:29:27 -07:00
mtail 5296742475 First pass at refactoring file locations.
This also reenables html proofing, which I accidentally left
off in an earlier commit.
2018-06-26 23:29:47 -07:00
Martin Taillefer ac1cbc7730
Improve linting script (#1582)
- Add useful error messages so people can self-serve when they get linting errors.

- Run all linters even if one fails. This gives you all the linting errors in one shot.
2018-06-25 06:46:47 -07:00
Jimmy Song b9f7174e2b quick start doc translation (#1523)
* quick start doc translation

* fix the markdown style

* enable Chinese spell checker
2018-06-18 06:08:12 -07:00
Martin Taillefer 857f86abad
Update Makefile for simplified Netlify scheme. (#1525) 2018-06-15 17:02:08 -07:00
mtail f8a5265efa Get all the bits in place to do docker-based build, generation, linting, and serving of the site. 2018-06-15 15:51:04 -07:00