Commit Graph

40 Commits (48c6b7ea96526952e33ff9bee913660b274b5cef)

Author SHA1 Message Date
Tim Hockin 15e2c62a3e Add a munger check for files that end in preformat 2015-09-25 13:56:50 -07:00
Carsten Clasohm d093fe0c4b add raw flag for GitHub download links 2015-09-07 17:43:09 -07:00
Mike Danese 5caf5e0191 point mugnedocs at new organization 2015-08-12 16:37:43 -07:00
Eric Paris 3c95bd4ee3 Add a whitespace munger
Strips all trailing whitespace from non-preformatted blocks
2015-07-30 20:41:30 -04:00
Eric Paris 8886a9940d Rewrite how the munger works
The basic idea is that in the main mungedocs we run the entirefile and
create an annotated set of lines about that file. All mungers then act
on a struct mungeLines instead of on a bytes array. Making use of the
metadata where appropriete. Helper functions exist to make updating a
'macro block' extremely easy.
2015-07-30 20:41:30 -04:00
Eric Paris 4cbca2e63c Make munger begin/end less generic
Just force the beginMungeTag() endMungeTag() macros on users, by hiding
it under the covers. It really simplies things for users.
2015-07-30 20:41:30 -04:00
Eric Paris 22fd8ac32d Speed up mungedoc TOC by pre-compiling a regex
Brings the time to run the TOC over the docs directory from .7 seconds
to .1 seconds
2015-07-30 20:41:29 -04:00
Ilya Dmitrichenko 5e7a6a8b89 Ignore home directory paths 2015-07-28 22:02:49 +01:00
Janet Kuo 180798cfa4 Use example syncer tags instead of hard-coded examples in doc 2015-07-27 14:48:41 -07:00
Mike Danese 0b14613361 Merge pull request #11622 from nikhiljindal/refactormark-new-version
Extracting out the code to versionize docs from mark-new-version and fixing a bunch of issues
2015-07-24 11:32:40 -07:00
nikhiljindal b0dbb318fe Extract out the versionize docs part in a separate script 2015-07-23 17:56:40 -07:00
Janet Kuo 6778f7f103 Implement mungedocs example syncer 2015-07-20 13:23:19 -07:00
Tim Hockin 8172551763 Fix the munger for code blocks - ticks at start of line 2015-07-18 14:06:08 -07:00
David Oppenheimer d28a6656ae Merge pull request #11452 from thockin/docs-munge-headerlines
Munge headerlines
2015-07-17 15:52:08 -07:00
Tim Hockin aacc4c864c Add a munger for header lines 2015-07-17 15:34:00 -07:00
Tim Hockin 6e4ec38f51 Make TOC munge include blank line before TOC 2015-07-17 15:06:54 -07:00
Daniel Smith 2c046685f6 fix util_test.go 2015-07-17 12:02:35 -07:00
Daniel Smith b563bb3760 fix unversioned test 2015-07-17 11:58:50 -07:00
Daniel Smith 2a112a0004 preformat checker 2015-07-17 11:04:46 -07:00
Tim Hockin 542e13d2d3 Better scary message 2015-07-17 09:28:49 -07:00
Janet Kuo 2498f93938 MUNGE generated table of contents should strip comma 2015-07-16 23:21:09 -07:00
Brian Grant 786b59427d Merge pull request #11400 from lavalamp/munger
Add absolute path link checking to munger
2015-07-16 22:50:14 -07:00
Daniel Smith 4d1bf3a0ca absolute link checking 2015-07-16 16:23:19 -07:00
Tim Hockin f7512d007b Add munger to verify kubectl -f targets, fix docs 2015-07-16 15:39:45 -07:00
Eric Tune f1c7915d71 Merge pull request #11325 from JanetKuo/toc
Make MUNGE generated TOC bookmark work for symbols
2015-07-15 12:56:37 -07:00
Janet Kuo de755bf59b Make MUNGE generated table of contents (TOC) bookmark work when there are symbols in the headline 2015-07-15 11:26:51 -07:00
Mike Danese d4d99deb97 make mungedoc exit 1 if manual changes are needed and wire up erro message. 2015-07-15 11:20:11 -07:00
Tim Hockin 6277801f82 Change warning.png to not go through a redirect 2015-07-14 17:28:10 -07:00
Tim Hockin c4953c6287 Add an image to unversioned warnings 2015-07-14 15:28:59 -07:00
Daniel Smith bf77ecc3a9 Various munger changes
* Add analytics munger w/ munge heading
* More link autofixes
* Allow running a subset of munges
* Fix repo root detection
* Only process non-preformatted blocks
* Gendocs no longer adds the analytics link; mungedocs does that in a
  second pass.
2015-07-13 17:47:48 -07:00
Eric Tune 950b11f198 Ignore comments in code when generating ToC. 2015-07-13 15:53:05 -07:00
Tim Hockin ad8f8731b6 Use a common set of tag prefixes for munges
All munges now start with `<!-- BEGIN MUNGE:` and end with `<!-- END MUNGE:`.
This lets me (in a followup) filter them better to normalize contents during
verification of generated docs.
2015-07-13 11:23:07 -07:00
Tim Hockin 8fceb754d8 Add 'warning: is unversioned' header to all docs
Mungedocs will keep this updated in head, and it will get stricken from
releases.
2015-07-13 11:23:07 -07:00
Zach Loafman 5c894b765b Fix mungedocs for absolute paths
chdir into the parent of the docs directory, then walk docs.

Fixes #11111
2015-07-11 13:19:55 -07:00
Tim Hockin 8ff8559c4c Add util functions 2015-07-10 17:13:19 -07:00
Tim Hockin 95cd66d3a0 use 'lines []string' for updateMacroBlock 2015-07-10 17:13:19 -07:00
Tim Hockin 2e781fed49 Break util func into a new file 2015-07-10 17:13:19 -07:00
Tim Hockin 84ad1792ea Run all munges on all docs
Rather than terminating, Collect the errors and print them per-file-per-munge.
2015-07-10 17:13:19 -07:00
Daniel Smith c4aab16b04 Adds a link fixer/checker to mungedocs.
Links that don't work yet can be prefixed with "TODO:" to avoid the check.
2015-07-10 10:54:47 -07:00
Eric Tune c51e35e835 Support for in-place modification of docs
Adds cmd/mungedocs which is framework for processing
all files under docs/ and either verifying that no changes needed or
making in-place changes.

Did not reuse kube::util::gen-docs because that seemed to be
centered around handling added files, and this pass does not
add files.

Planned uses:
 - table of contents automatic updating
 - linkification
 - internal link checker
 - link-path-relativizer or absolutizer
 - example file syncer
 - header inserter.

Just table-of-contents updating in this PR.

Added Table of Contents to docs/networking.md.

Demonstrates use of new TOC generator presubmit.
Other docs will be added in future PRs.
Additional development will be needed to handle some
of the more complex cases.
2015-07-08 14:58:54 -07:00