Mindwerks / worldengine

World generator using simulation of plates, rain shadow, erosion, etc.
MIT License
982 stars 128 forks source link

Added initial biomes document. #147

Closed esampson closed 8 years ago

esampson commented 8 years ago

I'm going to write up a document to outline the various biomes. Mostly I'll probably be cutting and pasting from various other sources.

Right now the document just has a chart that shows the colors and color codes for the various biomes and groups them according to Leeman's aggregation of the Holdridge life zones. I had a document at one point that spelled out what the various zones were in better detail but I can't find it at the moment. As I do I will update the doc.

psi29a commented 8 years ago

It is great that you did this, but I would rather not have binary data in the repo.

Is there another way to store the data besides PDF (proprietary format that it is)? Like LaTeX or even html?

Can the data go into the wiki?

esampson commented 8 years ago

Sure. I only used PDF because I thought it would be more convenient. It produces a very standard output. HTML was my second choice.

psi29a commented 8 years ago

I want to eventually use Sphinx to handle our documentation. Sphinx uses RST (reStructuredText) and very similar to markdown. With this, we can have http://readthedocs.org host our documentation and produce PDFs, LaTeX and HTML for us on every release.

For now, HTML is fine until we get sphinx setup. :)

Is it possible to split your html into two files, the markup itself and CSS? If it isn't possible, no worries. Thanks again for the work! :)

psi29a commented 8 years ago

Crap, I still the pdf in your commit. Sorry to be a bother, but can you create a new branch but only with your last commit please? :)

esampson commented 8 years ago

My second commit doesn't remove the PDF? Weird.

I can split the file into HTML and CSS but I was trying to keep it a single file. Of course I may be adding some pictures later on and that will require multiple files anyway, so I suppose there's no real point to that.

If you can just confirm that the second commit isn't removing the PDF then I will just create a new branch.

coder-molok commented 8 years ago

( Hi all, I follow this project from over a year without time to spend for you... now, I hope this will be usefull... )

You can embed images in html file with 'data' URI. See how here: https://en.wikipedia.org/wiki/Data_URI_scheme

psi29a commented 8 years ago

This PR has two commits, first commit is with pdf and the second removes it and adds html. So the total PR contains both files. If you can remove the first commit (a bit of git dark-magic) that would work, but the easiest is to just create a new branch with just the last commit (HTML) file. Then send another PR and close this.

ftomassetti commented 8 years ago

This would close #40

esampson commented 8 years ago

Ok. Looks like I figured out the proper git commands.

psi29a commented 8 years ago

Awesome, merged! :)

tcld commented 8 years ago

I am having trouble with this, too:

lists of files in version control and sdist do not match!

missing from sdist:

  docs

  docs/Biomes.html

suggested MANIFEST.in rules:

  recursive-include docs *.html

ERROR: InvocationError: '/home/travis/build/Mindwerks/worldengine/.tox/manifest/bin/check-manifest'

___________________________________ summary ____________________________________

ERROR:   manifest: commands failed

Something has to be added somewhere. Yes, that's all I know.^^ Currently all manifest-tests are failing due to this.

psi29a commented 8 years ago

add this to manifest.in

recursive-exclude docs *.html