jmalarcon / miis Goto Github PK

I have some generated Markdown files that contain inline HTML (paragraph) tag. When the <p> tag is part of a list it is ignored. Consequently the output looks not very nice and is in many cases not readable.

MD source:

<p>First Paragraph</p><p>Second Paragraph</p>

- Item 1  
  <p>First Paragraph in List Item 1</p>
  <p>Second Paragraph in List Item 1</p>
- Item 2 <p>First Paragraph in List Item 2</p> <p>Second  Paragraph in List Item 2</p>

The output on MIIS looks as follows:

Expected Result start:

First Paragraph

Second Paragraph

• Item 1

  First Paragraph in List Item 1

  Second Paragraph in List Item 1

• Item 2

  First Paragraph in List Item 2

  Second Paragraph in List Item 2

Expected Result end:

Hint: Preview was tested for commonmark/markdig on https://babelmark.github.io

Hi,

I have been using MIIS to set up a portal site that needs to access content from other servers. Rather than hardcode the URL into the files I wanted to create a variable to store the base path. I added to the web.config the key.
<add key="MIIS:videos" value="http://server_name/VideoSite"/>

Now in the MD file I am having problems using the key. I can use the following
<a href="{{videos}}/index.html">Test vid1</a>

But, this does not evaluate to the same html.
[Test vid2]({{videos}}/index.html)

I have tried googling, but not with much success. Any pointers would be appreciated.

Many thanks.

1. How do i make sure only the first level is visible in the menu (Antwerpen, Limburg, …)
   and only the children becoming visible after clicking on a parent:
   example:
   www .archief.be

There seems also be an issue in application.cs:

SCRIPT5007: SCRIPT5007: Unable to get property 'addEventListener' of undefined or null reference

but in the source file itself I can't see it, it is compacted/minimized javascript.

Hello,
I am downloaded your latest MIIS Source Code to me.
But unfortunately the compiled result does not work anymore.
The used templates are in your Source Code, below UI_Templates.
I always get the error:

Invalid template: The {{content}} placeholder must be present! 
  Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code. 

 Exception Details: System.Exception: Invalid template: The {{content}} placeholder must be present!

Source Error: 
Line 171:                    throw new Exception("Invalid template: The " + FIELD_PREFIX + "content" + FIELD_SUFIX + " placeholder must be present!"); 
Line 172:
Line 173:                HttpRuntime.Cache.Insert(templatePath, templateContents, new CacheDependency(templatePath)); //Add result to cache with dependency on the file
Line 174:                return templateContents; //Return content
Line 175:            }
  

 Source File:  c:\TFS_WS\Git\MIIS\src\MIISHandler\Helper.cs    Line:  173 

Stack Trace: 


[Exception: Invalid template: The {{content}} placeholder must be present!]
   MIISHandler.Helper.readTemplate(String templateVirtualPath, HttpContext ctx) in c:\TFS_WS\Git\MIIS\src\MIISHandler\Helper.cs:173
   MIISHandler.HTMLRenderer.RenderMarkdown(MarkdownFile md) in c:\TFS_WS\Git\MIIS\src\MIISHandler\HTMLRenderer.cs:43
   MIISHandler.MarkdownFile.get_HTML() in c:\TFS_WS\Git\MIIS\src\MIISHandler\MarkdownFile.cs:115
   MIISHandler.MIISHandler.ProcessRequest(HttpContext ctx) in c:\TFS_WS\Git\MIIS\src\MIISHandler\MIISHandler.cs:74
   System.Web.CallHandlerExecutionStep.System.Web.HttpApplication.IExecutionStep.Execute() +599
   System.Web.HttpApplication.ExecuteStep(IExecutionStep step, Boolean& completedSynchronously) +171

I've spotted a problem in the Material theme where the numbering per subsection does not restart per new subsection…

(folder) structure in toc.md:

#### [Troubleshooting](/troubleshooting/index.md)
* [General](/troubleshooting/general/index.md)
	* [foo](/troubleshooting/general/foo.md)
* [Email](/troubleshooting/email/index.md)
	* [bar](/troubleshooting/email/bar.md)
* [Printing](/troubleshooting/printing/index.md)
	* [xxx](/troubleshooting/printing/xxx.md)

how could this be solved?

Several questions that are not clear from the documentation.

1. Is there a possibility to add search to the site? if yes? how

2. When using subdirectories, is it possible to link to pages without having the .md file name?

Site/SubFolder/index.md
Site/SubFolder/otherpage.md

now if I use toc.md I link to:
[Some link](/SubFolder/otherpage.md)
but the url contains .md like: http://mysite.com/SubFolder/otherpage.md
Is there a way to remove the .md from the url? if I do:
[Some link](/SubFolder/otherpage) I get an error not found.

As you can see in the screenshots for the $' issue a new parapraph is opened and the $' is not rendered in the html at all.

When I had a look on babelmark
the Markdig implementation renders it correctly. Sure that the issue does not exist in the MIIS logic?

Thank you very much!

Originally posted by @ritti in #27 (comment)

Could you please provide further information on how to host MIIS on an IIS Server (not IIS Express)?

I'm not sure what are the basic requirements, but I couldn't make it run (error 500.19).

This problem occurs because the ApplicationHost.config or Web.config file contains a malformed or unidentified XML element. IIS can't identify the XML elements of the modules that are not installed. For example, IIS URL Rewrite module.

With the theme Material, sublevels are hidden by default in the TOC. But when entering the level, all sublevels are shown.

Is it possible to extend so the TOC has support for more levels than two?

I wanted to leave a note for anyone else that may have struggled with an IIS install.

To install on a vanilla Windows Server 2016/2019:

• Install IIS and ASP.NET4.5

Install-WindowsFeature Web-Server,Web-Asp-Net45 -IncludeManagementTools

• Install URL Rewrite

• Copy contents of MIIS-v3.4.0.-Release to C:\inetpub\wwwroot

Wolla 🎉

What would be the best strategy to work with images when working with MIIS having multiple subfolders (e.g. multi-level navigation).

1. Create one big directory to store all images (single flat level, no subdirectories)

/MySite
--/IMAGES
----unicorn.png
--index.md
--/Subsection
----index.md
----foo.md
--/Subsection2
----/SubSubsection3
------index.md
----index.md
----foo.md
----bar.md

2. Create an image folder per level?

/MySite
--/IMAGES
----unicorn.png
--index.md
--/Subsection
----/IMAGES
------unicorn.png
----index.md
----foo.md
--/Subsection2
----/IMAGES
------unicorn.png
----/SubSubsection3
------/IMAGES
--------unicorn.png
------index.md
----index.md
----foo.md
----bar.md

3. Create one big directory to store all images but add subfolders per subdirectory of the site to organize them?

/MySite
--/IMAGES
----/Subsection
------unicorn.png
----/Subsection2
------/Subsection3
--------unicorn.png
------unicorn.png
----unicorn.png
--index.md
--/Subsection
----index.md
----foo.md
--/Subsection2
----/SubSubsection3
------index.md
----index.md
----foo.md
----bar.md

Pros:

1. simple

2. Different images with same name in different sections are possible; If you work in a subsection you know the folder to look at and don't have to scroll each time to the top to that one images directory; If you cleanup a section, you don't have to worry that images could be used in another (sub)section.

3. different images with same name in different sections are possible; If you cleanup a section, you don't have to worry that images could be used in another (sub)section.

Cons:

1. No different images with same name are possible; annoying if you need to scroll each time back to that folder to use an image; removing or renaming an image can end up having subsections of your site without images.

2. more folders

3. Duplicate folderstructure, harder to keep in sync when renaming subsites

I think the second method is preferred. What do you think? (I ask this question with editor in mind. I know you have freedom about this but would like to put structure in it).

(+What would be a good (and valid for IIS) folder name? Images? _Images? img? .img? .Images? _img? …?)

Suppose you have a toc file in which you reference {{a}} which is defined in the web.config as a reference to the ~\a.md file. Then you have a file named b.md. When you open /b.md the {{a}} doesn't get evaluated in the toc section of the render if and only if it is not mentioned in the b.md file.

My goal is to make a section maybe called "Nextcloud" and subsections for clients and administrators. But when I use [Nextcloud](nextcloud/index.md) a navigation link I got navigation errors when I click the link when I am already inside the section.

Hi man,

I really looking forward to test MIIS on my Windows 10 maschine but I can not get it to run under IIS 10.
I managed all issues for now but after getting directory listing enabled and clicking the default.md file I got a new error:

HTTP-Fehler 500.21 - Internal Server Error
Der Handler ".md extension" weist das ungültige Modul "ManagedPipelineHandler" in der Modulliste auf.
[...]
Modul | IIS Web Core
-- | --
ExecuteRequestHandler
.md extension
0x8007000d

Any hints for this? I am really new to IIS .. coming from apache and nginx ;)

Hi,
On IIS 7.5 and windows server 2008 R2, I don't see any syntax highlight on code blocks. I have properly included the language tags like so:

<appSettings>
  <add key="MIIS:cssfile" value="/ts/docs/github-markdown.css" />
</appSettings>
<system.webServer>
  <handlers>
    <add name=".md extension" path="*.md" verb="GET" type="MIISHandler.MIISHandler, MIISHandler" resourceType="File" requireAccess="Read"/>
  </handlers>
</system.webServer>

In:
https://github.com/jmalarcon/MIIS/releases
The link for the 1.0.0 zip is broken:
https://github.com/jmalarcon/MIIS/releases/download/1.0.0/MIIS-1.0.0.zip

Hi
I downloaded your latest Release, but the Tool does not support links without Extension. Example (100E75FF). It works (100E75FF.md). But our documentation tool result do generate files otherwise.

The VisualStudio Plugin (MarkdownEditor) using the same Core (markdig) and its supports this Linking.
And that's why I using your Viewer.

Feature request: a search option, to allow searching in content (and menu?)

Maybe a start can be given so that we can help/commit?

Just testing

Hi José!

Take a look at the https://github.com/lunet-io/markdig/blob/master/src/Markdig/MarkdownExtensions.cs#L502

You can pass plus-separated list of extensions. Which can be configurable from web.config of your project.

Also, I had to patch MarkdownFile.cs to change the markdig behavior to process cyrillic headings correctly, instead of replacing them with section, section-1 things as per this issue 95 @ markdig: xoofx/markdig#95

Consider adding these 2 lines to MarkdownFile.cs @ line 85:

mdPipe.Extensions.Remove(mdPipe.Extensions.Find<AutoIdentifierExtension>());
mdPipe.UseAutoIdentifiers(AutoIdentifierOptions.AutoLink);

Ironically, such behavior cannot be configured with the mentioned plus-separated list of extensions.

I'm using the following md file.

---
author: Author One
category: Category
keyword: [keyword1, keyword2]
---

# Test with YAML Front Matter

some text

I'm running into the following issue:

With Version 2.3.0 (MIISHanlder.dll Version 2.3.0) I'm facing the following behaviour regarding YAML Front Matter also when templating is disabled: All meta data is rendered within a <h2> tag in html:

With Version 2.2.0 (MIISHandler.dll Version 2.2.0) this was not the case:

I have a template with a placeholder for keywords where I use the YAML Front Matter keywords to add the html meta data DC.keywords

Template Material main.html

Expected Behaviour:

Behaviour with Version 2.3.0:
The variable will not be replaced and is empty because of the YAML Front Matter keywords are already converted to h2 tag.

Can we use Razor within this markdown files also ?

How can I configure MIIS to use multiple languages?