Mercurial > vim

comparison runtime/doc/syntax.txt @ 18639:cb3163d590a1

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update runtime files. Commit: https://github.com/vim/vim/commit/09c6f265b21065ffa9437837b1d0955137175e45 Author: Bram Moolenaar <Bram@vim.org> Date: Sun Nov 17 15:55:14 2019 +0100 Update runtime files.
author Bram Moolenaar <Bram@vim.org>
date Sun, 17 Nov 2019 16:00:05 +0100
parents 1cd44535be32
children 99586852c2db
comparison
equal deleted inserted replaced
18638:453f4942f6cf 18639:cb3163d590a1
1 *syntax.txt* For Vim version 8.1. Last change: 2019 Oct 27 1 *syntax.txt* For Vim version 8.1. Last change: 2019 Nov 14
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
474 need to explicitly source/enable anything that will affect the HTML 474 need to explicitly source/enable anything that will affect the HTML
475 conversion. See |-E| and |-s-ex| for details. It is probably best to create a 475 conversion. See |-E| and |-s-ex| for details. It is probably best to create a
476 script to replace all the -c commands and use it with the -u flag instead of 476 script to replace all the -c commands and use it with the -u flag instead of
477 specifying each command separately. 477 specifying each command separately.
478 478
479 *hl-TOhtmlProgress* *TOhtml-progress-color*
480 When displayed, the progress bar will show colored boxes along the statusline
481 as the HTML conversion proceeds. By default, the background color as the
482 current "DiffDelete" highlight group is used. If "DiffDelete" and "StatusLine"
483 have the same background color, TOhtml will automatically adjust the color to
484 differ. If you do not like the automatically selected colors, you can define
485 your own highlight colors for the progress bar. Example: >
486
487 hi TOhtmlProgress guifg=#c0ffee ctermbg=7
488 <
479 *g:html_number_lines* 489 *g:html_number_lines*
480 Default: current 'number' setting. 490 Default: current 'number' setting.
481 When 0, buffer text is displayed in the generated HTML without line numbering. 491 When 0, buffer text is displayed in the generated HTML without line numbering.
482 When 1, a column of line numbers is added to the generated HTML with the same 492 When 1, a column of line numbers is added to the generated HTML with the same
483 highlighting as the line number column in Vim (|hl-LineNr|). 493 highlighting as the line number column in Vim (|hl-LineNr|).
505 diff.html#W1L42 jumps to line 42 in the first window in a diff 515 diff.html#W1L42 jumps to line 42 in the first window in a diff
506 diff.html#42 does the same 516 diff.html#42 does the same
507 < 517 <
508 *g:html_use_css* 518 *g:html_use_css*
509 Default: 1. 519 Default: 1.
510 When 1, generate valid HTML 4.01 markup with CSS1 styling, supported in all 520 When 1, generate valid HTML 5 markup with CSS styling, supported in all modern
511 modern browsers and most old browsers. 521 browsers and many old browsers.
512 When 0, generate <font> tags and similar outdated markup. This is not 522 When 0, generate <font> tags and similar outdated markup. This is not
513 recommended but it may work better in really old browsers, email clients, 523 recommended but it may work better in really old browsers, email clients,
514 forum posts, and similar situations where basic CSS support is unavailable. 524 forum posts, and similar situations where basic CSS support is unavailable.
515 Example: > 525 Example: >
516 :let g:html_use_css = 0 526 :let g:html_use_css = 0
578 d: diff filler 588 d: diff filler
579 589
580 Example, to make the fold column and line numbers uncopyable: > 590 Example, to make the fold column and line numbers uncopyable: >
581 :let g:html_prevent_copy = "fn" 591 :let g:html_prevent_copy = "fn"
582 < 592 <
583 This feature is currently implemented by inserting read-only <input> elements 593 The method used to prevent copying in the generated page depends on the value
584 into the markup to contain the uncopyable areas. This does not work well in 594 of |g:html_use_input_for_pc|.
585 all cases. When pasting to some applications which understand HTML, the 595
586 <input> elements also get pasted. But plain-text paste destinations should 596 *g:html_use_input_for_pc*
587 always work. 597 Default: "fallback"
598 If |g:html_prevent_copy| is non-empty, then:
599
600 When "all", read-only <input> elements are used in place of normal text for
601 uncopyable regions. In some browsers, especially older browsers, after
602 selecting an entire page and copying the selection, the <input> tags are not
603 pasted with the page text. If |g:html_no_invalid| is 0, the <input> tags have
604 invalid type; this works in more browsers, but the page will not validate.
605 Note: this method does NOT work in recent versions of Chrome and equivalent
606 browsers; the <input> tags get pasted with the text.
607
608 When "fallback" (default value), the same <input> elements are generated for
609 older browsers, but newer browsers (detected by CSS feature query) hide the
610 <input> elements and instead use generated content in an ::before pseudoelement
611 to display the uncopyable text. This method should work with the largest
612 number of browsers, both old and new.
613
614 When "none", the <input> elements are not generated at all. Only the
615 generated-content method is used. This means that old browsers, notably
616 Internet Explorer, will either copy the text intended not to be copyable, or
617 the non-copyable text may not appear at all. However, this is the most
618 standards-based method, and there will be much less markup.
588 619
589 *g:html_no_invalid* 620 *g:html_no_invalid*
590 Default: 0. 621 Default: 0.
591 When 0, if |g:html_prevent_copy| is non-empty, an invalid attribute is 622 When 0, if |g:html_prevent_copy| is non-empty and |g:html_use_input_for_pc| is
592 intentionally inserted into the <input> element for the uncopyable areas. This 623 not "none", an invalid attribute is intentionally inserted into the <input>
593 increases the number of applications you can paste to without also pasting the 624 element for the uncopyable areas. This prevents pasting the <input> elements
594 <input> elements. Specifically, Microsoft Word will not paste the <input> 625 in some applications. Specifically, some versions of Microsoft Word will not
595 elements if they contain this invalid attribute. 626 paste the <input> elements if they contain this invalid attribute. When 1, no
596 When 1, no invalid markup is ever intentionally inserted, and the generated 627 invalid markup is inserted, and the generated page should validate. However,
597 page should validate. However, be careful pasting into Microsoft Word when 628 <input> elements may be pasted into some applications and can be difficult to
598 |g:html_prevent_copy| is non-empty; it can be hard to get rid of the <input> 629 remove afterward.
599 elements which get pasted.
600 630
601 *g:html_hover_unfold* 631 *g:html_hover_unfold*
602 Default: 0. 632 Default: 0.
603 When 0, the only way to open a fold generated by 2html.vim with 633 When 0, the only way to open a fold generated by 2html.vim with
604 |g:html_dynamic_folds| set, is to click on the generated fold column. 634 |g:html_dynamic_folds| set, is to click on the generated fold column.