Click or drag to resize
AMDL to MAML Converter

This topic describes the AMDL to MAML Converter, a.k.a. amdl2maml.

Goal

Provide a means of feeding AMDL topics into existing tools (i.e., SHFB).

Building

Dependencies are:

Converter

  1. Metadata (TBD).

  2. AMDL fork of CommonMark.NET.

  3. AMDL fork of PCLStorage.

Converter.Console

  1. AMDL fork of PCLStorage targeting .NET Framework.

  2. Ditto.CommandLine (TBD).

Status

Topic Types

  1. Empty Topic

  2. General Topic

  3. Glossary Topic

  4. How-To Topic

  5. Orientation Topic

Entities

  1. Sections and subsections, including See Also.

  2. Topic and section outlines from setext-style headers.

  3. Topic summaries and introductions.

  4. Paragraphs, quotes and soft and hard line breaks.

  5. Ordered, bulleted and unbulleted lists.

  6. Alerts and containers.

  7. Fenced and indented code blocks.

  8. Commands, including parameters and switches.

  9. Inline code.

  10. Inline internal, local and code links.

  11. Inline URI and email links.

  12. Block and inline images.

  13. Ordinary weak and strong emphases.

  14. Special weak and strong emphases.

  15. math and new term.

  16. Subscript and Superscript.

  17. Block and inline HTML.

The following is an incomplete list of missing entities:

  1. Table.

  2. Definition List.

Ideally, amdl2maml should produce an SHFB project without human intervention. Right now it can only read/write the content layout XML.

Notice
Copy
Copyright © Dmitry Shechtman 2015

Licensed under the Apache License, Version 2.0 (the "License").
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

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.
See Also