Freeciv-manual.exe putters!

Various topics about the game, the website, or anything else Freeciv related that doesn't fit elsewhere.
User avatar
Arbogast
Elite
Posts: 412
Joined: Tue Jul 16, 2013 9:09 am
Location: France

Freeciv-manual.exe putters!

Postby Arbogast » Tue Sep 03, 2013 9:43 pm

I tried the Freeciv-manual.exe that comes with versions 2.3.x and 2.4.x and it doesn't come out right.
I got empty pages and scrambled ones too due to the coding - instead of 'western europe (windows)' it should be UTF-8, for instance.
and then, the images don't show. Among other things...
I'm really interested in getting the Terrain and Building charts as they are different from earlier versions.

As sugested, I sent the error messages to gna.org, but I don't know what kind of language they speak... :mrgreen:

Maybe we can get some answers here in the good old forum.freecic.org! :D

User avatar
Arbogast
Elite
Posts: 412
Joined: Tue Jul 16, 2013 9:09 am
Location: France

Re: Freeciv-manual.exe putters!

Postby Arbogast » Sat Sep 07, 2013 9:40 pm

What? Nobody cares about the differences in the Terrain or the Building charts?

cazfi
Elite
Posts: 1750
Joined: Tue Jan 29, 2013 6:54 pm

Re: Freeciv-manual.exe putters!

Postby cazfi » Sun Sep 08, 2013 9:35 am

I'll try to look into fixing freeciv-manual to 2.4.1 (its problems are not going to block 2.4.0 release now that we're in release candidates phase). By "trying" I mean I have to invent some more hours to my days to do that among all the other things I've already committed to...

User avatar
Arbogast
Elite
Posts: 412
Joined: Tue Jul 16, 2013 9:09 am
Location: France

Re: Freeciv-manual.exe putters!

Postby Arbogast » Sun Sep 08, 2013 9:56 am

Oh! I understand very well with your load of work allright!
I'm surprised that so few people participate in this site.
So, courage LoneRanger!

User avatar
JTN
Elite
Posts: 472
Joined: Wed Jan 30, 2013 12:15 am

Re: Freeciv-manual.exe putters!

Postby JTN » Sun Sep 08, 2013 12:18 pm

It's probably worth noting that freeciv-manual, even when working as designed, is probably going to be a bit disappointing to end users. Really, all it's useful for at the moment is as a helper to keep pages on the central wiki like this one up-to-date with new releases (and we haven't actually done so for several releases). We probably shouldn't even be shipping it.

Some of its issues:
  • While its output is called manualX.html, it's not really HTML, it's fragments of MediaWiki markup (some of which is HTML). So while the pages display in a web browser, they look mangled.
  • (This probably explains your character encoding trouble -- there's no declaration of that, or even a <html> opening tag.)
  • Similarly, the generated content references images that are assumed to exist in the context of a wiki, so it's not self-contained.
  • Of ruleset things, only covers buildings/wonders and terrain, and not e.g. units and governments.
All these things could be rectified -- clearly people would find a standalone game manual useful -- but personally I concentrate limited effort on improving the in-game help at the moment.

All that said, the current crop of bugs causing error messages (that will be fixed) only affect the server options page (manual1.html). All the other generated pages (including terrain and buildings) are as good as they're likely to get.

cazfi
Elite
Posts: 1750
Joined: Tue Jan 29, 2013 6:54 pm

Re: Freeciv-manual.exe putters!

Postby cazfi » Sun Sep 08, 2013 12:43 pm

JTN wrote:It's probably worth noting that freeciv-manual, even when working as designed, is probably going to be a bit disappointing to end users. Really, all it's useful for at the moment is as a helper to keep pages on the central wiki like this one up-to-date with new releases (and we haven't actually done so for several releases). We probably shouldn't even be shipping it.

I consider custom ruleset authors "end-users" of what we ship (clearly end-user of the ruleset is another thing). As an ruleset author I would find working freeciv-manual to produce html for ruleset homepage useful. But I agree that in general in-game help has higher priority, and freeciv-manual improvements should be about low-hanging fruits only (I think something can be easily done in conjunction with freeciv-ruledit development, as the bugfix I already made shows).
For Freeciv project, I'd like to get pages about the new supplied rulesets to wiki (civ2civ3 in 2.5, alien in 2.6). Classic ruleset is less important in that there's at least old pages present, and they are not that outdated (practically when freeciv engine gets new ruleset modding features, they are added to classic ruleset with values corresponding to old hardcoded behavior)

User avatar
Arbogast
Elite
Posts: 412
Joined: Tue Jul 16, 2013 9:09 am
Location: France

Re: Freeciv-manual.exe putters!

Postby Arbogast » Sun Sep 08, 2013 3:13 pm

I can understand your priorities allright. But these "minor" things are important to a lot of newbies, even to not so-newbies.
That's where we could come in. Fer inztanz: I have been updating the "Terrain Values" from workers to engineers. From older versions to the Amplio series.
Now we have the "default3" and that's another ball game. If we could have some tips, we could tackle those "minor" priorities.
Maybe in my 'Coffee Shop" Post? :)

JTN: have you clicked the "this one" button? Oh Boy!

cazfi
Elite
Posts: 1750
Joined: Tue Jan 29, 2013 6:54 pm

Re: Freeciv-manual.exe putters!

Postby cazfi » Sun Sep 08, 2013 4:23 pm

Arbogast wrote:JTN: have you clicked the "this one" button? Oh Boy!

Yep, latest revision claims to have fixed some layout problem (maybe it did for some browser), but it's the previous revision that works for me.

User avatar
Arbogast
Elite
Posts: 412
Joined: Tue Jul 16, 2013 9:09 am
Location: France

Re: Freeciv-manual.exe putters!

Postby Arbogast » Mon Sep 09, 2013 2:00 pm

I'm talking about the building chart in the 'this one' link.
Here's how it looks in my FireFox.
Attachments
wiki-buildings.jpg

cazfi
Elite
Posts: 1750
Joined: Tue Jan 29, 2013 6:54 pm

Re: Freeciv-manual.exe putters!

Postby cazfi » Mon Sep 09, 2013 3:01 pm

Same for me, but previous revision from wiki history is ok for me: http://freeciv.wikia.com/wiki/Buildings?oldid=16674

Comment about that latest edit is: "Same probkem as in Wonders, same hack"
and Wonders edit comment: "Move "other languages" to the left, stacked side bars floating right cannot work with a full width table breaking their floating attempts"