Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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 |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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. |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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
|
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
Sounds great, but I am looking for something I can host privately in the company.
|
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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
|
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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. ... [show rest of quote] |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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. |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
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, On Sat, Jan 24, 2015 at 12:53 AM, wimdeblauwe [via Asciidoctor :: Discussion] <[hidden email]> wrote:
... [show rest of quote] -- Dan Allen | http://google.com/profiles/dan.j.allen |
Free forum by Nabble | Edit this page |