server help: generating html doc

pelican · Post by **pelican** » Mon May 30, 2005 4:19 am

Hi,

I'm new in CrossFire. After looking through sourceforge intending to run a small mmorpg for a small group of players, found out about crossfire and it seems nice.

I have successfully setup and run on a linux server.

Now, i want to generate html player/spoiler guide from the crossfire package but i encounter problem.

I've check the crossfire distribution, under the doc directory, there is a /playerbook-html/ and /spoiler-html/

it seems that i need to do some stuff to generate the complete html files.
but i am not sure what command or how should i do it?

i have ssh access to my server.

i've posted in the mailing list but no response.
can anyone advise me.

Thanks.

cavesomething · Post by **cavesomething** » Mon May 30, 2005 5:28 am

I believe it should've been created during the make step....

on a cvs copy i have lying around, I see the following files.

$ ls
arche-extract bow-extract empty.pbm mag-extract Makefile.am shield-extract spoiler.html stats-extract
arm-extract CVS helm-extract Makefile Makefile.in spells-extract spoiler.shtml weap-extract

where spoiler.shtml is the html file, and looks similar to the pages linked from http://crossfire.real-time.com/spoiler/index.html

it is possible leaf has done some manual editing of that version, you would need to ask him though.

pelican · Post by **pelican** » Mon May 30, 2005 6:02 am

if you meant the normal
make
make install

during installing of server.
after i've done that which is successfully make and running the server and successfully connect to the server and play crossfire on my server.

those extracts in the doc folder doesnt seems to be extracted and no new html been generated.

i thought i need to run special command to extract and generate those html files...

Kevin Rudat · Post by **Kevin Rudat** » Mon May 30, 2005 9:07 am

I don't know who or how, but the generated Makefile doesn't do anything interesting by default.

make handbook does interesting things, however.

If you want the faces, you'll need an arch directory in your crossfire lib directory, leading to the arch. tree, as well as having some 'giftrans' installed.

This is less then ten minutes' fiddling, including writing this post. There's almost certainly other things that are broken.

pelican · Post by **pelican** » Mon May 30, 2005 11:28 am

by looking into the Makefile of /doc/playerbook-html/
it did show that it will generate many other .html

but i've tried to make every single file in /doc/playerbook-html/ and /doc/spoiler-html/ , nothing seems to happen.

there are those -extract files in the directory, there should be some way to generate a complete html guide out.

Website · Post by **Leaf** » Tue May 31, 2005 3:17 am

cavesomething wrote: it is possible leaf has done some manual editing of that version, you would need to ask him though.

The spoiler and handbook pages on the website have been heavily modified and tweaked over the years with mixed results.

pelican · Post by **pelican** » Tue May 31, 2005 6:02 am

is the generation of the doc/spoiler-html/ and doc/handbook-html/ working?

techolous · Post by **techolous** » Tue May 31, 2005 9:03 pm

last time I tried, forgot how I did it though

pelican · Post by **pelican** » Wed Jun 01, 2005 2:19 am

did you success in making the doc?

Website · Post by **Leaf** » Fri Jun 03, 2005 7:44 pm

From the mailing list:

> Hi,
>
> I finally know how to generate html guide of cross by someone giving
> me hint at irc.
>
> cd into /doc/spoiler-html/
>
> make archive

make spoiler.html is the more proper command in this case.

>
> However, there are some problems. make archive is suppose to generate
> various html of monster, spells, etc. But in the linux server
> distribution of crossfire-1.7.0, after i run the command, it cant find
> spellist.h in the include directory.

yes - it appears the spoiler generation was never updated for the new spell logic.

>
> And many images are not generated.
>
> i have the /lib/arch installed.
>
> After checking in the /doc/scripts/monster.pl , the code seems
> correct, it is suppose to read the graphics file ***.base.111.png ,
> etc. at the lib/arch/monster directory.
>
> But when running the make archive, it tried to read ***.111.png ,
> without the base... therefore causing reading error file not found and
> generate 0 byte .gif
>
>
> Can anyone advise on how to solve the broken image problem? Or is that
> html guide generating script having problem?

make archive is meant to pack up all the generated data into a tar archive.
If you haven't made the files first, via the make spoiler.html, it won't have
the stuff to pack up.

I just tried it - there were some errors generating some of the images, but
this appered to be more a problem with perhaps the pngtopnm program not liking
the original files, vs path problem.