-
Notifications
You must be signed in to change notification settings - Fork 15
/
Copy pathREADME.htm
258 lines (258 loc) · 11.9 KB
/
README.htm
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
<style type="text/css">
code{
font-family: "Consolas", monospace;
}
pre{
border: 1px solid #ddd;
border-left: 3px solid #f36d33;
overflow: auto;
padding: 1em 1.5em;
display: block;
}
Blockquote{
border-left: 3px solid #d0d0d0;
padding-left: 0.5em;
margin-left:1em;
}
Blockquote p{
margin: 0;
}
table{
border:1px solid;
border-collapse:collapse;
}
th{ padding:5px;
border:1px solid;
}
td{
padding:5px;
border:1px solid;
}
</style>
<h1>Markdown Editor and Shell Extensions <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-yellowgreen.svg" alt="License"/></a></h1>
<p><strong>Latest Version 2.3.1 - 15 Sep 2024</strong></p>
<p><strong>A collection of tools for markdown files, to edit and view content:</strong></p>
<ul>
<li><p>A <strong>Markdown Text Editor</strong> to manually edit a markdown file, with instant preview of the output in a HTML Viewer.</p>
</li>
<li><p>A <strong>Preview handler</strong> which allows you to see the content of the markdown file without open it, in the “Preview Panel”, integrated into Windows Explorer.</p>
</li>
</ul>
<h3>Features</h3>
<ul>
<li><p>No need to built the project with Delphi: an easy Setup is provided.</p>
</li>
<li><p>Supports Windows Vista, 7, 8, 10 and 11 (for 32 bits and 64 bits).</p>
</li>
<li><p>Themes (Dark and Light) according to user preferences of Windows Theme</p>
</li>
<li><p>Integrated also with other Shell Applications (like XYplorer)</p>
</li>
</ul>
<h3>Delphi: integration with MarkDown Help Viewer</h3>
<ul>
<li>For Delphi developers: use this tool to prepare and integrate a Help System in your application, using the <a href="https://github.com/EtheaDev/MarkdownHelpViewer">“MarkDown Help Viewer”</a> project.</li>
<li>Use the <strong>Markdown Text Editor</strong> to edit your help files and use the <strong>Markdown Help Viewer</strong> to show them.</li>
</ul>
<h3>Setup using the Installer</h3>
<p>Click to download the <a href="https://github.com/EtheaDev/MarkdownShellExtensions/releases/latest/download/MDShellExtensionsSetup.exe">MDShellExtensionsSetup.exe</a> located also in the Release area. The Installer works both for 32 and 64 bit system.</p>
<p><img src="./Images/Setup.png" alt="Markdown Setup_Program"/></p>
<p><strong><em>For a clean Setup close all the windows explorer instances which have the preview handler active or the preview handler was used (remember the dll remains in memory until the windows explorer was closed).</em></strong></p>
<h3>Markdown Text Editor</h3>
<p>A useful Text editor with instant preview of Markdown formatted content:</p>
<p><img src="./Images/MDTextEditorLight.png" alt="Markdown Text Editor Dark"/></p>
<h3>Manual Build and Installation (only for Delphi developers)</h3>
<p>Learn more about the manual within our <a href="https://github.com/EtheaDev/MarkdownShellExtensions/wiki/Manual-Build-and-Installation">wiki</a>. Dive deeper into everything related to this tool, its features, and how to make the most of it.</p>
<h3>Preview Panel in action</h3>
<p>In Windows 10 with Dark theme:</p>
<p><img src="./Images/PreviewPanelDark.png" alt="Preview Panel Dark"/></p>
<h3>Manual Build and Installation (only for Delphi developers)</h3>
<p>If you have Delphi 12, you can manually build the projects using:</p>
<p>\Source\MDShellExtensionsGroup.groupproj</p>
<p>or the command: Build.bat (defining location of your Delphi environment)</p>
<p><strong><em>Warning: To simplyfy build of the projects, some third parties libraries are located into ext folder</em></strong></p>
<p>To manually install the SVGShellExtensions.dll follow these steps:</p>
<ol>
<li><p>Close all the windows explorer instances which have the preview handler active or the preview handler was used (remember the dll remains in memory until the windows explorer was closed).</p>
</li>
<li><p>If you have already used the installer uninstall the components from system.</p>
</li>
<li><p>To install manually the dll run the <code>Unregister_Register.cmd</code> (run-as-administrator): notice that you must change the path into cmd file.</p>
</li>
</ol>
<h2>Release Notes</h2>
<p>15 Sep 2024: ver. 2.3.1</p>
<ul>
<li>Built with Delphi 12.2</li>
</ul>
<p>28 Aug 2024: ver. 2.3.0</p>
<ul>
<li>Use of TFormTabsBar component (Delphi 12) for paging</li>
<li>Use of Styled Message Dialogs</li>
<li>Updated Setup to show errors registering dlls</li>
</ul>
<p>28 May 2024: ver. 2.2.5</p>
<ul>
<li>File Changed notification and reload only when App has focus</li>
<li>Small icons on Message Dialogs</li>
</ul>
<p>23 May 2024: ver. 2.2.4</p>
<ul>
<li>Fixed Registration of dll extension during Setup</li>
<li>Updated the latest Image32 library</li>
</ul>
<p>21 May 2024: ver. 2.2.3</p>
<ul>
<li>Added Packages in External Sources</li>
<li>Changed MessageDialogs with small animations</li>
<li>Fixed Version number into Installer</li>
</ul>
<p>10 May 2024: ver. 2.2.2</p>
<ul>
<li>Fixed Explorer Preview for Chinese chars</li>
<li>Added use of StyledComponents and Rounded Buttons in Explorer Preview</li>
<li>Fixed Initialization of GDI+</li>
</ul>
<p>09 May 2024: ver. 2.2.1</p>
<ul>
<li>Added File Changed notification and reload</li>
<li>Fixed Preview for Chinese chars</li>
<li>Added use of StyledComponents and Rounded Buttons</li>
<li>Built with Delphi 12.1</li>
<li>Built with Latest Image32 Library</li>
<li>Built with Latest Skia4Delphi 6.1 Library</li>
</ul>
<p>20 Mar 2024: ver. 2.2.0</p>
<ul>
<li>Fixed resize content when changing Monitor</li>
<li>Updated to latest version of HTMLViewer</li>
</ul>
<p>13 Jan 2024: ver. 2.1.0</p>
<ul>
<li>Built with Delphi 12</li>
<li>Updated Copyright</li>
<li>Aligned to MarkDown HelpViewer project</li>
<li>Added create table wizard</li>
</ul>
<p>3 Nov 2023: ver. 2.0.2</p>
<ul>
<li>Added “mark” command in markdown toolbar</li>
<li>Recognized 1) same as 1. (ordered list)</li>
<li>Added .text and .txt extensions to editor/shell extensions</li>
</ul>
<p>25 Oct 2023: ver. 2.0.1</p>
<ul>
<li>Fixed some “hints”</li>
<li>Uses System Border and Shadows for Forms</li>
</ul>
<p>24 Oct 2023: ver. 2.0.0</p>
<ul>
<li>Added use of Skia4Delphi</li>
<li>Added support for new image format (webp and wbmp)</li>
<li>Uses AnimatedStyledDialogs for messages</li>
<li>Added toolbar for markdown commands</li>
<li>Added dialog for input of hyperlink for Images and Files</li>
<li>Updated Markdown library with best support for CommonMark transformation</li>
</ul>
<ol>
<li>Subscript <sub>text</sub> and Superscript <sup>text</sup></li>
<li>Formulas (using <a href="https://developers.google.com/chart/infographics/docs/formulas">Google Chart API</a>)</li>
<li><mark>Markers</mark></li>
<li><a href="https://www.markdownguide.org/basic-syntax/#reference-style-links">Reference-style Links</a></li>
</ol>
<p>29 Jun 2023: ver. 1.5.2</p>
<ul>
<li>Fixed loading images with “spaces” in the filename</li>
<li>Fixed immediate-loading of new images when editing the file</li>
<li>During loading of remote images, user can stop loading pressing “Esc”</li>
<li>Updated Copyright for the Editor</li>
</ul>
<p>26 Jun 2023: ver. 1.5.1</p>
<ul>
<li>Fixed Preview of Markdown files with extensions different from .markdown</li>
</ul>
<p>24 Jun 2023: ver. 1.5.0</p>
<ul>
<li>Autoload local markdown files when clicked into Preview</li>
<li>The editor can open all markdown extensions: .md, .mkd, .mdwn, .mdown, .mdtxt, .mdtext, .markdown, .txt, .text'</li>
<li>Stopped image rendering during editing to speed-up</li>
<li>Added useful close button on Tabs</li>
<li>Hint full filename on Tabs</li>
<li>Save/Discard messaged default response inverted</li>
<li>Removed Settings “Search In Folder”</li>
</ul>
<p>1 Nov 2022: ver. 1.4.3</p>
<ul>
<li>Fixed loading images into Preview</li>
<li>Fixed the setting for local loading</li>
</ul>
<p>11 Set 2022: ver. 1.4.1</p>
<ul>
<li>Added Combobox for easy selection Markdown Dialect</li>
<li>Added Windows 11 light and dark styles</li>
<li>Fixed load file with blanks in content menu</li>
<li>Fixed loading ANSI files</li>
<li>Fixed AV in Settings with opened files</li>
</ul>
<p>20 Jan 2022: ver. 1.3.0</p>
<ul>
<li>Added Support for Windows 11</li>
<li>Fixed resize content</li>
</ul>
<p>04 Sep 2021: ver. 1.2.0</p>
<ul>
<li>Added Support for Delphi 11</li>
<li>Updated Image32 Lib</li>
</ul>
<p>20 Jul 2021: ver. 1.1.0</p>
<ul>
<li>Added Image32 Lib to best rendering of SVG Images</li>
</ul>
<p>06 Jul 2021</p>
<ul>
<li>First public release with setup</li>
</ul>
<h2>Credits</h2>
<p>Many thanks to <strong>Rodrigo Ruz V.</strong> (author of <a href="https://theroadtodelphi.com/">theroadtodelphi.com</a> Blog) for his wonderful work on <a href="https://theroadtodelphi.com/category/previewhandler/">delphi-preview-handler</a> from which this project has used a lot of code and inspiration.</p>
<h2>License</h2>
<p>Licensed under the <a href="https://opensource.org/licenses/Apache-2.0">Apache License, Version 2.0</a> (the “License”);</p>
<p>Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.</p>
<h3>Other libraries from Ethea:</h3>
<p><strong>SVGIconImageList</strong> - https://github.com/EtheaDev/SVGIconImageList/</p>
<p><strong>StyledComponents</strong> - https://github.com/EtheaDev/StyledComponents</p>
<p><strong>Delphi MarkdownProcessor</strong> - https://github.com/EtheaDev/MarkdownProcessor</p>
<h3>Third parties libraries:</h3>
<p><strong>OpenSLL Library</strong>: Cryptography and SSL/TLS Toolkit</p>
<p>Copyright © 1998-2018 The OpenSSL Project. All rights reserved.</p>
<p><strong>Delphi Markdown</strong> - https://github.com/grahamegrieve/delphi-markdown</p>
<p>Copyright (c) 2011+, Health Intersections Pty Ltd All rights reserved</p>
<p><strong>Delphi Preview Handler</strong> - https://github.com/RRUZ/delphi-preview-handler</p>
<p>The Initial Developer of the Original Code is Rodrigo Ruz V.
Portions created by Rodrigo Ruz V. are Copyright © 2011-2023 Rodrigo Ruz V.</p>
<p><strong>SynEdit</strong> - http://synedit.svn.sourceforge.net/viewvc/synedit/</p>
<p>all rights reserved.</p>
<p><strong>Synopse/SynPDF</strong> - https://github.com/synopse/SynPDF</p>
<p>Copyright © Synopse: all right reserved.</p>
<p><strong>HtmlToPdf</strong> - https://github.com/MuzioValerio/HtmlToPdf</p>
<p>Copyright © Muzio Valerio.</p>
<p><strong>Image32 Library</strong> - http://www.angusj.com/delphi/image32/Docs/_Body.htm</p>
<p>Copyright ©2019-2023 Angus Johnson.</p>
<p><strong>dzlib</strong> - https://sourceforge.net/projects/dzlib/</p>
<p>Copyright (c) Thomas Mueller</p>
<p><strong>HTMLViewer</strong> - https://github.com/BerndGabriel/HtmlViewer</p>
<p>Copyright (c) 1995 - 2008 by L. David Baldwin</p>
<p>Copyright (c) 1995 - 2023 by Anders Melander (DitherUnit.pas)</p>
<p>Copyright (c) 1995 - 2023 by Ron Collins (HtmlGif1.pas)</p>
<p>Copyright (c) 2008 - 2009 by Sebastian Zierer (Delphi 2009 Port)</p>
<p>Copyright (c) 2008 - 2010 by Arvid Winkelsdorf (Fixes)</p>
<p>Copyright (c) 2009 - 2023 by HtmlViewer Team</p>
<h1>External projects</h1>
<p><strong><em>To simpilfy compilation of projects they are added into ext folder</em></strong></p>
<p><a href="https://github.com/EtheaDev/SVGIconImageList">SVGIconImageList</a></p>
<p><a href="https://github.com/BerndGabriel/HtmlViewer">HtmlViewer</a></p>
<p><a href="https://github.com/RRUZ/vcl-styles-utils">vcl-styles-utils</a></p>
<p><a href="https://github.com/EtheaDev/MarkdownProcessor">markdownProcessor</a></p>
<p><a href="https://github.com/EtheaDev/StyledComponents">StyledComponents</a></p>
<p><a href="https://sourceforge.net/projects/dzlib/">dzlib</a></p>
<p><img src="/Setup/SupportingDelphi.jpg" alt="Delphi Support"/></p>
<p>Related links: <a href="https://www.embarcadero.com/">embarcadero.com</a> - <a href="https://learndelphi.org/">learndelphi.org</a></p>