Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Descriptions.md not loading on IIS [Fixed - Sharing info] #149

Closed
welcomebrand opened this issue Nov 28, 2017 · 3 comments
Closed

Descriptions.md not loading on IIS [Fixed - Sharing info] #149

welcomebrand opened this issue Nov 28, 2017 · 3 comments
Assignees
@Andy-set-studio
Labels
support

Comments

@welcomebrand
Copy link

I don't suppose you have many Windows users but reporting this just in case you want to update your install docs for those who may run into this issue. Details and fix below.

Cheers.

Tell us about the issue you are experiencing

When you install Astrum for the first time on a Windows server it's possible that when you view the styleguide you'll get an error saying the library description files won't load.

What behaviour would you expect?

The library should just load as normal.

How can this issue be replicated?

Install Astrum on a Windows machine where your site is running on IIS.

Screenshots / Screencast

patternlibraryerror

Your environment

Platform: Windows 10
OS Version:
Node Version:
NPM Version:
Astrum Version: 1.9.5

To fix

The cause of this is that Markdown is not a supported MIMETYPE on IIS by default so you need to add this setting into your IIS config.

How to edit your MIMETYPE settings on IIS
The Markdown MIMETYPE setting required

Once you've updated this in IIS, you should be able to just refresh your pattern library and it will work as expected.
@Andy-set-studio
Copy link
Contributor

Thanks for this @welcomebrand, We really appreciate it!

I'll assign myself to update the installation documentation 🙂

@Andy-set-studio Andy-set-studio self-assigned this Nov 28, 2017
@Andy-set-studio
Copy link
Contributor

PR created: #150

Thanks again, @welcomebrand!

@dsagner
Copy link

dsagner commented Jan 26, 2018

I've successfully edited my MIMETYPE setting on IIS and I added the IISMarkdownHandler locally to my .NET MVC project, the markdown content is now getting read and inserted to it's respected placeholders, but before each of them I get a "<!doctype html>" tag rendered whether or not the description.md file contains some text inside it. I have this only locally on my machine, therefore a screenshot is being added to this comment. I haven't made any changes to the intro.md file for the Introduction page to test if it is present on the generated files after astrum initialization in the project folder. Did I just miss something from the links above or can the cause be something else?

Screenshot 1

Screenshot 2

@dsagner dsagner mentioned this issue Feb 4, 2018
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@Andy-set-studio Andy-set-studio

Labels
support
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@welcomebrand @Andy-set-studio @dsagner