HTML5 publish

[pybonvin]

Hi all,

When I publish a project in HTML5 no error during the upload but the site is empty: only the skin (local - everything works perfectly)

What's wrong ?

Thanks for your help

Best regards

[RamonS]

What exactly do you mean with "the site is empty"? Are there no files or you do no see topic content? Any errors reported in the log on the web server? Which web server do you use? Which browser do you use? Is it the same problem with all browsers / systems?

[pybonvin]

All the files are uploaded but no content is display - no log on the server and same problem on Firefox - Chrome and IE.

files.png

The result is the following

result.png

[Ineffable]

Check your Javascript settings. My guess is something is preventing it from firing.

[RamonS]

You can install the FireBug add-on in Firefox and get detailed information about what is failing. In IE you can press F12 and get the console output. That might give some more clues as to what is (not) happening.

[LTinker68]

Make sure you don't have Mark of the Web enabled for that output, too. That can cause unpredictable results for content hosted on a web server.

[Feebeegeebee]

Did you get a solution to this?
If not,
a:) are you publishing to a UNIX/Linux based server? and
b:) do you have the "Do not use Content folder" option enabled for HTML5 output?

I experienced a similar problem publishing my help on a Linux webserver.

There is a bug where if you enable the "Do not use Content folder" option AND you are using HTML5 output.
There are two 'Resources' folders at the root level of the project. One is for the HTML5 code and is required and the other is the Resources folder for the project. However, in Windows you cannot have two folders with the same name so they get merged. Project files need 'resources' and HTML5 code is looking for 'Resources'. Both are required.

If you rename the Resources folder in your Content Explorer to something else (e.g. "properties"), rebuild your help and re-publish it to your webserver, you should be able to work around this issue (fingers crossed).
Regards,
Feebeegeebee

[HeraTech]

Awesome. I knew I couldn't be the only one having an issue generating HTML5 on Windows and then publishing to a UNIX server. MadCap Forums to the rescue again!

Renaming the Resources file in my Content Explorer solved my problem (which was, as described by Feebeegeebee, that the Project files were looking for a 'resources' folder (lowercase) and the HTML5 code is looking for a 'Resources' folder (uppercase) and I couldn't have both!).

[Feebeegeebee]

Hi HeraTech,
Very pleased to be able to help.
If you get a chance, please log this as a bug too. There are several issues with publishing to non-Microsoft web server that need addressing and the more people who log them, the better.
Regards,
Feebeegeebee

[HeraTech]

Bug report filed.

Some additional things to note:

Selecting the "Do not use "Content" folder in output" setting does seem to be part of the problem. I couldn't reproduce this unless I selected that option.

Renaming the Resources folder in your project can break links to resources (images, snippets, stylesheets). I'm still finding tables that lost their link to their table stylesheet. Just an FYI, if you find this thread before MadCap fixes this bug.

[LindaW]

I was so relieved to find these posts! I've been unable to post updates to my project for weeks - the content just would not display! I found it very strange, since my project is about 3 years old - and I've never encountered this problem before. So THANK YOU to those who posted solutions for this!

In trying to remember anything that I might have changed, I think that I selected Generate Sitemap for the first time when problems started with the project. I don't know if that could have done any damage or not. I hesitate to select it again, until I know.

So, I've re-named my Resources folder, as suggested. That has enabled my content to display when I publish - a major step in the right direction!

I still have hundreds (if not thousands) of broken links to repair. Most - almost all - of my broken links are within snippets. Either links to images within snippets, or to snippets within snippets. So, this makes me wonder if the hyperlinks are just too long? I'm considering just eliminating the Resources folder altogether, and moving the folders within directly under Contents. However, I am hesitant, not wanting to end up with even more broken links. I'd also like to re-name those folders, to keep them together (something like 1Images, 1Stylesheet, 1Snippets, etc.). I tried this in a sample project though, and even though I got the window in Flare that indicated it was resolving links, I did end up with broken links from moving / renaming the Image folder.

Has anyone moved these folders - without breaking links to images and Snippets? Is it worth it, to try to shorten the links to my Snippets and Images?

Thanks such helpful suggestions!
Linda

[dorcutt]

Usually, if a filename is too long, then you'll get an error that says that specifically. Sometimes the content explorer just misses fixing some links; I've yet to work out the details. Snippets are especially prone to breaking for me as well, so I don't think it's a file name length issue necessarily. You can test this by manually trying to link to the correct image and seeing if that works.

This may or may not be obvious, but you can use the Find and Replace feature with the "Find in Source" button checked to fix these links. Of course, before attempting a major surgery like this, export your project to a separate zip file as a manual backup and make sure everything's checked into any source control you may have.

What I like to do is I fix a single Image, note what changed in the relative filepath. So, I look at one of the broken images, keep it, and then Insert a new image right next to it that links to the image the first one is supposed to connect to. The broken image might have a relative path like this:

Code: Select all

src="../../../Resources/Images/Product Name/03000005.png" 

and the correct path might be this now:

Code: Select all

src="../../../Not Resources/Images/Product Name/03000005.png" 

I'd do a search for this string "../../../Resources/Images/" and replace it with the correct one: "../../../Not Resources/Images/". Out of an abundance of caution, I do one type of thing (images, snippets, cross references) separately, look things over carefully, then try the next sort of item, instead of doing a full replace of "../../../Resources/Images/" with " ../../../Not Resources/Images/". I also do the first ten or so manually by clicking the Find Next and Replace buttons before really going for it and clicking the "Replace All" button.

Good luck!