How to host generated HTML ?

classic Classic list List threaded Threaded
8 messages Options
Reply | Threaded
Open this post in threaded view
|

How to host generated HTML ?

wimdeblauwe
Hi,

I am wondering how other people do this. Suppose i create some shared library for my company and document it with asciidoc. I use Maven to build and release it. I would like to upload the generated HTML to some website that will host this and I want to keep every version. A bit similar to what spring for example does.

Do you setup an apache or a jetty or something that points to a directory where you somehow upload the file(s)? Is there something like Nexus for deploying the jar file that can do this?

How have other people tackled this?

regards,

Wim
Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

abelsromero
Hi,

I've never done this, but I can point in some direction. To generate some package ready to deploy you can try to use jBake (http://jbake.org/, for Java) or Jekyll (http://jekyllrb.com/, for Ruby), both support AsciiDoc.
As far as I know, the own asciidoctor page is done with Ke

Doing some google on the matter I found this article about how to integrate jBake with maven, http://docs.ingenieux.com.br/project/jbake/walkthrough.html.

I hope this helps :)

Please, let me know of your progress because I'm interested in this matter too.
Ted
Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

Ted
In reply to this post by wimdeblauwe
GitHub would do what you want.

They will host a website for you out of your https://github.com/username/username.github.io repository for free. Whatever you push to the master branch there is automatically served up as a website at http://username.github.io/

e.g. I'm using the free repository (public to everyone)
https://github.com/tedbergeron/tedbergeron.github.io
http://tedbergeron.github.io/

for more information about GitHub Pages: https://help.github.com/categories/github-pages-basics/

----

The other option is to save all your file versions to your own repository.

Then find a "web hosting" provider and pay them to host your website. FTP your HTML files you've generated to the host and you've got a website.

If you don't need your website to be public, you could host it yourself in-house. On one of your servers, set up Apache (on Linux) or IIS (on Windows). Copy your generated HTML files to the host directory and you have got the start of your own intranet website.

- Ted @TedAtCIS
Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

wimdeblauwe
Sounds great, but I am looking for something I can host privately in the company.
Ted
Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

Ted
To run your it all in-house at your company.

If you don't already have a file repository, look into Mercurial http://mercurial.selenic.com/ It allows you to put your repository where ever you want on your network. That would give you the version history you are looking for.

Then hosting your HTML pages on the network would be doable. You don't need a server, just any computer that is permanently on your network. If you happen to have a Linux box, it probably has Apache web server already installed. Even if you just had a desktop computer with Windows, you could use that to host your website. You can run Apache on Windows, but typically if you have Windows you'd just use IIS web server.

Your website could be accessed over the LAN by browsing to the IP address of the computer http://999.999.999/ 
- Ted @TedAtCIS
Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

wimdeblauwe
Hi,

we are using Stash (GIT) as our SCM already.

I guess I was more looking for a Maven plugin that would allow me to upload the pages automatically to somewhere. Maybe I should ask this on the Maven mailing list.

Ideally, this would make it so I automatically get URLs like:


whenever I release a Maven library.

I guess that setting up a linux box with Apache and an FTP server might probably be the easiest.

regards,

Wim

2015-01-23 21:45 GMT+01:00 Ted [via Asciidoctor :: Discussion] <[hidden email]>:
To run your it all in-house at your company.

If you don't already have a file repository, look into Mercurial http://mercurial.selenic.com/ It allows you to put your repository where ever you want on your network. That would give you the version history you are looking for.

Then hosting your HTML pages on the network would be doable. You don't need a server, just any computer that is permanently on your network. If you happen to have a Linux box, it probably has Apache web server already installed. Even if you just had a desktop computer with Windows, you could use that to host your website. You can run Apache on Windows, but typically if you have Windows you'd just use IIS web server.
- Ted @TedAtCIS



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/How-to-host-generated-HTML-tp2691p2699.html
To unsubscribe from How to host generated HTML ?, click here.
NAML

Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

CodeGnome
In reply to this post by wimdeblauwe
You host HTML with the web server of your choice. How to run a web server is outside the reasonable scope of a question since entire books are written on the subject, but if you're already running Apache or similar you can simply place your Asciidoctor output and image assets somewhere inside your document root.

The correct placement of linked icons and images for your web server will vary, but AsciiDoctor icons and images can also be embedded inline. The pros and cons of embedding image assets are numerous, so your mileage will vary.
Reply | Threaded
Open this post in threaded view
|

Re: How to host generated HTML ?

mojavelinux
Administrator
In reply to this post by wimdeblauwe
There are about as many ways to publish the content as there are stars in the sky :)

To manage the publishing with Maven, specifically, you could look at a plugin such as the scm-publish-plugin. It seems to be close to what you are looking for. I may have used it once a long time ago, but I no longer remember the details.

http://maven.apache.org/plugins/maven-scm-publish-plugin/

I hope that helps a little.

Cheers,

-Dan

On Sat, Jan 24, 2015 at 12:53 AM, wimdeblauwe [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi,

we are using Stash (GIT) as our SCM already.

I guess I was more looking for a Maven plugin that would allow me to upload the pages automatically to somewhere. Maybe I should ask this on the Maven mailing list.

Ideally, this would make it so I automatically get URLs like:


whenever I release a Maven library.

I guess that setting up a linux box with Apache and an FTP server might probably be the easiest.

regards,

Wim

2015-01-23 21:45 GMT+01:00 Ted [via Asciidoctor :: Discussion] <[hidden email]>:
To run your it all in-house at your company.

If you don't already have a file repository, look into Mercurial http://mercurial.selenic.com/ It allows you to put your repository where ever you want on your network. That would give you the version history you are looking for.

Then hosting your HTML pages on the network would be doable. You don't need a server, just any computer that is permanently on your network. If you happen to have a Linux box, it probably has Apache web server already installed. Even if you just had a desktop computer with Windows, you could use that to host your website. You can run Apache on Windows, but typically if you have Windows you'd just use IIS web server.
- Ted @TedAtCIS



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/How-to-host-generated-HTML-tp2691p2699.html
To unsubscribe from How to host generated HTML ?, click here.
NAML




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/How-to-host-generated-HTML-tp2691p2700.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--