Martin,

Good news.  So did you download and build trunk or install SCons  
separately?

Regarding APIs, there is both a C++ api and a Python API.

I assume you are looking for Python API documentation? You can get  
basic boost::python generated api documentation through pydoc.

Also. I've been starting to write docstrings for the major classes,  
like mapnik::Layer and mapnik::Map.

For example do:

$ pydoc -p 8080 # to serve all your python documentation

Then go to http://localhost:8080/mapnik._mapnik.html

And notice a few classes with docstrings at 
http://localhost:8080/mapnik._mapnik.html#Layer 
  or http://localhost:8080/mapnik._mapnik.html#Map

The problem with PyDoc is that it's often too much for beginners. One  
solution is to poke through the examples code here:

http://code.google.com/p/mapnik-utils/

What we really need is some nice narrative documentation, but that  
hard to find time for.

Dane





On Feb 16, 2009, at 11:18 AM, Michael L Martin wrote:

> Thank you, Dane-
>
> This also corrected some compile-time errors I was seeing.
> Being very, very new to mapnik, is there a convenient place on the
> web where one can browse the API? All I see on the documents link
> is the install doc and the tutorials.
>
> Thanks,
> Mike
>
>
> Dane Springmeyer wrote:
>> The version of Scons-local bundled with Mapnik 0.5.1 is not  
>> compatible
>> with Python 26.
>>
>> However, Mapnik trunk fixed #164 but upgrading the version of SCons-
>> local distributed with mapnik (in Trunk) and the upcoming 0.6 release
>> works great with python 2.6
>>
>> So, you can either upgrade to mapnik trunk or like Nico recommended,
>> build mapnik with an external install of SCons.
>>
>> The syntax for that would be:
>>
>> $ cd mapnik_source_code
>> $ SCons # instead of python scons/scons.py
>>
>> Dane
>>
>>
>>
>> On Feb 16, 2009, at 8:28 AM, tschobber tschöbbi wrote:
>>
>>
>>> Hi,
>>>
>>> I have some troubles installing Mapnik 0.5.1 from source on
>>> openSuse11.1: When I run the scons.py in the source directory, I
>>> always get the following error:
>>>
>>> /usr/bin/python2.6 scons/scons.py
>>> scons: Reading SConscript files ...
>>> /downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/SCons/
>>> Platform/posix.py:37: DeprecationWarning: The popen2 module is
>>> deprecated.  Use the subprocess module.
>>> import popen2
>>> /downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/SCons/ 
>>> Tool/
>>> msvs.py:37: DeprecationWarning: the md5 module is deprecated; use
>>> hashlib instead
>>> import md5
>>> Building on Linux ...
>>> Checking for C library m... AttributeError: 'NodeList' object has no
>>> attribute 'name':
>>> File "/downloads/mapnik-0.5.1/SConstruct", line 174:
>>>   if not conf.CheckLibWithHeader(libinfo[0], libinfo[1], 'C') and
>>> libinfo[2]:
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/SConf.py", line 606:
>>>   ret = apply(self.test, (context,) +  args, kw)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/SConf.py", line 946:
>>>   call = call, language = language, autoadd = autoadd)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/Conftest.py", line 510:
>>>   ret = context.BuildProg(text, suffix)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/SConf.py", line 793:
>>>   return not self.TryBuild(self.env.Program, text, ext)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/SConf.py", line 766:
>>>   return apply(self.sconf.TryBuild, args, kw)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/SConf.py", line 530:
>>>   nodes = builder(target = target, source = source)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/Environment.py", line 214:
>>>   return apply(MethodWrapper.__call__, (self, target, source) +
>>> args, kw)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/Environment.py", line 178:
>>>   return apply(self.method, nargs, kwargs)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/Builder.py", line 614:
>>>   return self._execute(env, target, source, OverrideWarner(kw), ekw)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/Builder.py", line 548:
>>>   source = self.src_builder_sources(env, source, overwarn)
>>> File "/downloads/mapnik-0.5.1/scons/scons-local-0.97.0d20071212/
>>> SCons/Builder.py", line 727:
>>>   match_suffix = match_src_suffix(s.name)
>>>
>>> I've read this page (http://trac.mapnik.org/ticket/164) but I don't
>>> have any idea how to upgrade the scons.py because it is a single
>>> file just for the installation, or am I thinking wrong?
>>>
>>> I'm a big newbie on Mapnik :( and I would really appreciate if you
>>> could help me!
>>>
>>> Greetings,
>>>
>>> Martin
>>>
>>>
>>>
>>> -- 
>>> Jetzt 1 Monat kostenlos! GMX FreeDSL - Telefonanschluss + DSL
>>> für nur 17,95 Euro/mtl.!* http://dsl.gmx.de/?
>>> ac=OM.AD.PD003K11308T4569a
>>>
>>> -- 
>>> Psssst! Schon vom neuen GMX MultiMessenger gehört? Der kann`s mit
>>> allen: http://www.gmx.net/de/go/multimessenger01
>>> _______________________________________________
>>> Mapnik-users mailing list
>>> [email protected]
>>> https://lists.berlios.de/mailman/listinfo/mapnik-users
>>>
>>
>> _______________________________________________
>> Mapnik-users mailing list
>> [email protected]
>> https://lists.berlios.de/mailman/listinfo/mapnik-users
>>
>>
>
> _______________________________________________
> Mapnik-users mailing list
> [email protected]
> https://lists.berlios.de/mailman/listinfo/mapnik-users

_______________________________________________
Mapnik-users mailing list
[email protected]
https://lists.berlios.de/mailman/listinfo/mapnik-users

Reply via email to