Changes between Initial Version and Version 1 of MSWordFilter

Timestamp:

Nov 27, 2009, 3:15:21 PM (14 years ago)

Author:

Garry Yao

Comment:

Initialize paste from office reference

MSWordFilter

@@ +1 @@
+= Pasting from Microsoft Office Applications =
+CKEditor perform automatically content cleanup filtering and intelligent transformation when pasting content is detected come from MS-Office application family, this including Word,Excel,Outlook, etc, which will result in good content more semantically correct, while trying to preserve as much as the original format. 
+The following plugins are required depends on demand: 
+ 1. '''pastefromword''' plugin must present to deliver this functionality, when using it, you need to click the '''Paste From Word''' toolbar button to instruct the editor your clipboard content of this pasting is from MS Office applications.
+ 1. In order to auto-detect whether content is from Office application, the '''clipboard''' plugin must be configured, in this case, you just need to press keyboard 'Ctrl-V' or click on '''Paste''' toolbar button.
+
+
+ 
+=== Browser Native Filtering ===
+Each web browsers have it's own pasting system which may vary from the result that content been pasted from Office Word application, generally certain styles even text would loose during the pasting, the following table lists the known filter outs:[[BR]]
+
+||Browsers||IE||Firefox||Safari/Chrome||Opera
+||Document Structure Styles||NO||Yes||NO||NO
+
+=== CKEditor Filtering ===
+Further processing is handled by the editor based on browser's filtering result,the following table summarizes the rules that will affect the end result:[[BR]]
+
+
+{{{
+#!html
+<table class="collapse"> 
+ 
+<tr class="trbgeven"> 
+<th><strong>Format Removed</strong></th> 
+<th><strong>Result Affected</strong></th> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>Downlevel conditional comments content within  
+ 
+<pre><code>&lt;!--[</code></pre> 
+ 
+and  
+ 
+<pre><code>]--&gt;</code></pre> 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code>&lt;!--[if gte mso 9]&gt;...&lt;![endif]--&gt;</code></pre> 
+</td> 
+<td>WordArt cannot be edited, only the resulting static image is left. These comments make some HTML markup invisible to browsers earlier than Microsoft Internet Explorer 5. 
+ 
+<p>For example, Office inserts XML blocks containing WordArt document properties inside these comments so that the contents of these XML elements do not show up as text in browsers earlier than Internet Explorer 5.</p> 
+</td> 
+</tr> 
+ 
+<tr class="trbgeven"> 
+<td>Uplevel conditional comments within 
+ 
+<pre><code> 
+&lt;![
+</code></pre> 
+ 
+and 
+ 
+<pre><code> 
+]&gt;
+</code></pre> 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+&lt;! [if !vml]&gt;
+</code></pre> 
+</td> 
+<td>These comments make some HTML markup visible in browsers earlier than Internet Explorer 5 but invisible in Internet Explorer 5 or later. When the comments are removed, the markup indicating that static images should not be loaded in Internet Explorer 5 or later is lost. 
+ 
+<p>For example, WordArt is saved as HTML in two parts. One part is an XML block that describes the image. The other part is an actual image that makes the picture visible in older browsers that don't interpret XML. The static image is put inside uplevel comments to hide it from Internet Explorer 5 or later.</p> 
+</td> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>XML tags in the "o", "v", "w", "x", and "p" namespaces 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+&lt;o:p&gt;&lt;/o:p&gt;
+</code></pre> 
+</td> 
+<td>Paragraph mark formatting (if different from the paragraph) is lost. The <pre><code>&lt;o:p&gt;&lt;/o:p&gt;</code></pre> tags represent the character that Word treats as the paragraph mark.</td> 
+</tr> 
+ 
+<tr class="trbgeven"> 
+<td>@-rule definitions 
+ 
+<p><b class="bterm">Example</b><br></p> 
+ 
+<pre><code> 
+@page Section1
+               {size: 8.5in 11in }
+</code></pre> 
+</td> 
+<td>Page settings, such as page dimensions and orientation, are lost: 
+ 
+<ul> 
+<li> @page contains document page setup information</li> 
+ 
+<li> @font-face contains document font definitions</li> 
+ 
+<li> @list contains Office-specific bulleted and numbered list styles definitions</li> 
+</ul> 
+ 
+<p>To keep standard @ rule defintions, @page and @font-face, use the -a switch at the command prompt.</p> 
+</td> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>CSS comments containing  /* and */ 
+ 
+<p><b class="bterm">Example</b><br></p> 
+ 
+<pre><code> 
+/* List Definitions */
+</code></pre> 
+</td> 
+<td>Minimal impact on HTML document.</td> 
+</tr> 
+ 
+<tr class="trbgeven"> 
+<td>VML attributes, or any attribute with a colon ( : ) in the attribute name 
+ 
+<p><b class="bterm">Example</b><br></p> 
+ 
+<pre><code> 
+v:shapes="_x000_i1025"
+</code></pre> 
+</td> 
+<td>WordArt, clip art, and AutoShapes cannot be edited; only the resulting static image is left.</td> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>ProgID 
+ 
+<pre><code> 
+&lt;meta&gt;
+</code></pre> 
+ 
+tags 
+ 
+<p><b class="bterm">Example</b><br></p> 
+ 
+<pre><code> 
+&lt;meta name=ProgID content=Word.Document&gt;
+</code></pre> 
+</td> 
+<td>Minimal impact on HTML document. ProgID identifies the application the file was created in.  
+ 
+<p>You can also remove <b class="bterm">GENERATOR</b> and <b class="bterm">ORIGINATOR</b> <b class="bterm">META</b> tags, which contain the information about the HTML document's originating program (for example, Word or Excel) and the latest generating program (Office HTML Filter). To remove the <b class="bterm">GENERATOR</b> and <b class="bterm">ORIGINATOR</b> <b class="bterm">META</b> tags, use the -m switch at the command prompt.</p> 
+</td> 
+</tr> 
+ 
+<tr class="trbgeven"> 
+<td><b class="bterm">Link</b> elements with the <b class="bterm">rel</b> attribute set to any of the following: 
+ 
+<ul> 
+<li>"file-list"</li> 
+ 
+<li>"edit-time-data"</li> 
+ 
+<li>"ole-object-data"</li> 
+ 
+<li>"original-file"</li> 
+ 
+<li>"preview"</li> 
+</ul> 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code>&lt;link rel=File-Listhref="./mydoc_files/filelist.xml"&gt;</code></pre> 
+</td> 
+<td>The association with all the special extra files that contain Office-specific data, such as OLE object binaries, is lost.</td> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>The following XML namespace declarations - that is, the xmlns attribute setting: 
+ 
+<ul> 
+<li>"o"</li> 
+ 
+<li>"w"</li> 
+ 
+<li>"x"</li> 
+ 
+<li>"p"</li> 
+ 
+<li>"v"</li> 
+</ul> 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+xmlns:v="urn:schemas-microsoft-com:vml"
+</code></pre> 
+</td> 
+<td>The ability to render WordArt and clip art as vector images in the browser is lost. Instead, they become static images. 
+ 
+<p>To keep VML in the file, use the -v switch at the command prompt.</p> 
+ 
+<p>If either -o or -v is used at the command prompt, the XML namespace declarations remain in the file.</p> 
+</td> 
+</tr> 
+ 
+<tr class="trbgeven"> 
+<td>Empty <b class="bterm">style</b> attributes, especially when they become empty as a result of processing their values 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+style=""
+</code></pre> 
+</td> 
+<td>Minimal impact on HTML document.</td> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>"mso-" prefix properties 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+mso-margin-top-alt: 12pt;
+</code></pre> 
+</td> 
+<td>Office-specific formatting that stores Office document settings, which are are used when the HTML document is opened in Office. Some features, such as footnotes and customized bullet and numbering are lost. Word legacy frames become tables, and some edit-time language and font-formatting information is lost. 
+ 
+<p>To keep mso- prefix properties and other Office-specific properties, use the -o switch at the command prompt.</p> 
+</td> 
+</tr> 
+ 
+<tr class="trbgeven"> 
+<td>Other non-standard properties such as:  
+ 
+<ul> 
+<li>"tab-stops"</li> 
+ 
+<li>"tab-interval"</li> 
+ 
+<li>"language"</li> 
+ 
+<li>"text-underline"</li> 
+ 
+<li>"text-effect"</li> 
+ 
+<li>"text-line-through"</li> 
+ 
+<li>"font-color"</li> 
+ 
+<li>"horiz-align"</li> 
+ 
+<li>"list-image-1"</li> 
+ 
+<li>"list-image-2"</li> 
+ 
+<li>"list-image-3"</li> 
+ 
+<li>"separator-image"</li> 
+ 
+<li>"table-border-color-dark"</li> 
+ 
+<li>"table-border-color-light"</li> 
+ 
+<li>"vert-align"</li> 
+ 
+<li>"vnd.ms-excel.numberformat"</li> 
+</ul> 
+ 
+ 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+tab-interval: .5in;
+</code></pre> 
+</td> 
+<td>Tab settings are lost. All text underline styles become single underline. All underline colors become black. Engraved text and embossed text are lost.</td> 
+</tr> 
+ 
+<tr class="trbgodd"> 
+<td>Empty inline HTML elements: <b class="bterm">FONT</b>, <b class="bterm">EM</b>, <b class="bterm">STRONG</b>, <b class="bterm">SAMP</b>, <b class="bterm">ACRONYM</b>, <b class="bterm">CITE</b>, <b class="bterm">CODE</b>, <b class="bterm">DFN</b>, <b class="bterm">KBD</b>, <b class="bterm">TT</b>, <b class="bterm">B</b>, <b class="bterm">I</b>, <b class="bterm">U</b>, <b class="bterm">S</b>, <b class="bterm">SUB</b>, <b class="bterm">SUP</b>, <b class="bterm">INS</b>, <b class="bterm">DEL</b>, <b class="bterm">VAR</b>, <b class="bterm">SPAN</b>. An element is considered empty if it contains no displayable contents. 
+ 
+<p><b class="bterm">Example</b></p> 
+ 
+<pre><code> 
+&lt;FONT COLOR=blue&gt;&lt;B&gt;&lt;/B&gt;&lt;/FONT&gt;
+</code></pre> 
+</td> 
+<td>No impact on the display of the HTML document.</td> 
+</tr> 
+ 
+</table> 
+}}}