developer Digest, Vol 4, Issue 49

Wolfgang Spraul wolfgang at qi-hardware.com
Sat Oct 24 21:35:29 EDT 2009


Carlos,
what you and your team have been doing so far is already fantastic!

On my end, I want to cleanup the license thing a bit more, MediaWiki
supports some nice templates for that.
Your great work pushed me to add a number of extensions to our wiki:

1. latex math
texvc works now, you can embed latex math in <math> markup
http://meta.wikimedia.org/wiki/Help:Displaying_a_formula
has a reference and lots of samples of the supported TeX subset.

2. Graphviz
We now support <graphviz> markup which allows us to draw graphs, see
http://www.graphviz.org/Gallery.php
for examples.
Actually if someone is interested - the Graphviz Mediawiki extension is not
in very good shape. I had to do some hacking and guessing before I got
it to work. If you want to help look here:
http://www.mediawiki.org/wiki/Extension:Graphviz

3. ImageMap
<imagemap> maps are now supported, so we can annotate images.
http://www.mediawiki.org/wiki/Extension:ImageMap

4. OggHandler
We can now embed Ogg Theora video (and Ogg Vorbis audio).
http://www.mediawiki.org/wiki/Extension:OggHandler

---
Still on my list I want to look into better SVG support, and also I tried
to get the GNUplot extension to work, see
http://www.mediawiki.org/wiki/Extension:GnuplotBasic
But the problem is security. Gnuplot supports very powerful shell commands,
and to make this work on a public wiki with more or less unmonitored
registrations would require that someone writes a really strong filter before
the scripts get executed. Currently the extension does have a filter, but it
doesn't look very convincing, even the author says he would only use it on an
intranet wiki :-))
Or we run the gnuplot script in a really secure NOBODY account on the server.
Anyway, right now I have no time to continue with this, if someone is
interested to look into it please let me know.

> About the homepage introduction, I think that it's great! and How you said,
> that define the purpouse of the Qi-wiki. If you like, I can complete the
> Spanish version of this introduction 'cause I saw that it's not actualized
> yet.

Sure, great.

I will probably do a review of all images and drawings at some point, with the
goal to cleanup the licenses and metadata, as well as to make sure we have
the (editable) originals somewhere...
Keep up your great work, thanks a lot,
Wolfgang

On Sat, Oct 24, 2009 at 06:41:20PM -0500, Oscar Orjuela wrote:
> Hi Wolfgang
> 
> Thanks a lot for your opinion and suggestions. Our principal goal is
> generate support to the community, and for this reason we are very
> interested in hear the community's opinions and needs.
> 
> You have reason about the difference that have to between the Qi wiki and
> wikipedia, and all my Team are working on it now, writing ours own texts and
> uploading pictures and drawings made by ourself.
> 
> About the homepage introduction, I think that it's great! and How you said,
> that define the purpouse of the Qi-wiki. If you like, I can complete the
> Spanish version of this introduction 'cause I saw that it's not actualized
> yet.
> 
> So, we hope improve our work day by day and also, keep going hearing your
> opinions, because there are very important to our Team.
> 
> Thanks again. Regards,
> 
> Oscar Orjuela
> UNAL Developer Team
> 
> 2009/10/22 <developer-request at lists.qi-hardware.com>
> 
> > Send developer mailing list submissions to
> >        developer at lists.qi-hardware.com
> >
> > To subscribe or unsubscribe via the World Wide Web, visit
> >        http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer
> > or, via email, send a message with subject or body 'help' to
> >        developer-request at lists.qi-hardware.com
> >
> > You can reach the person managing the list at
> >        developer-owner at lists.qi-hardware.com
> >
> > When replying, please edit your Subject line so it is more specific
> > than "Re: Contents of developer digest..."
> >
> >
> > Today's Topics:
> >
> >   1. Re: Developer Team of UNAL - Colombia (Carlos Camargo)
> >   2. Re: Developer Team of UNAL - Colombia (Wolfgang Spraul)
> >
> >
> > ----------------------------------------------------------------------
> >
> > Message: 1
> > Date: Thu, 22 Oct 2009 08:07:49 -0500
> > From: Carlos Camargo <cicamargoba at gmail.com>
> > Subject: Re: Developer Team of UNAL - Colombia
> > To: "Hard- and Software Development, Kernel, Distribution,      Roadmap"
> >        <developer at lists.qi-hardware.com>
> > Message-ID:
> >        <19ebea720910220607j190abfdj351090a421edbce8 at mail.gmail.com>
> > Content-Type: text/plain; charset="iso-8859-1"
> >
> > On Thu, Oct 22, 2009 at 8:03 AM, Carlos Camargo <cicamargoba at gmail.com
> > >wrote:
> >
> > > Hi
> > >
> > >>
> > >> which I would really like to see, that is currently missing: how to set
> > >> up the Jz4720's registers so that things work.  For my current boot
> > >> method, I have simply copied the values for setting up the SDRAM from
> > >> the XBurst-tools source.  This works, of course, but I don't know what
> > >> I'm doing.  It would be nice to have a simple table saying "this is a
> > >> chip feature, with the nanonote you must set the register to ...", or
> > >> "this is an operating system choice, you can use this register to decide
> > >> ...", that sort of things.
> > >>
> > >
> > >
> >
> > Totally agree.
> >
> >
> >
> >
> > >
> > > Carlos
> > >
> > >
> > >
> > >
> > >> Thanks,
> > >> Bas
> > >>
> > >> On Wed, Oct 21, 2009 at 08:03:55PM -0500, Carlos Camargo wrote:
> > >> > Hi Oscar Thanks for introduce your team to the Qi community. We want
> > to
> > >> make
> > >> > a useful documentation for people with different professions or
> > Digital
> > >> > Design skills. I want to use this documentation as base for my
> > Embedded
> > >> > Design course in my University. Because of that, we will explain many
> > >> basic
> > >> > topics like: The difference between the Volatile and Non-Volatile
> > >> memories.
> > >> > The main goal with this documentation is contribute with information
> > >> that we
> > >> > can't find on wikipedia. We must be very careful with the use of
> > images
> > >> and
> > >> > contents, we must respect the copyright laws. We will document how the
> > >> > different Nano's components interact, and how the devices works on
> > Nano,
> > >> we
> > >> > will put some little code examples to explain the device use/and
> > >> > configuration. So a newer can understand with software example how the
> > >> > component works. We like to know what do you think about our idea.
> > >> Regards
> > >> > Carlos
> > >> >
> > >> > On Wed, Oct 21, 2009 at 6:26 PM, Oscar Orjuela <doskaro at gmail.com>
> > >> wrote:
> > >> >
> > >> > > Hi everybody,
> > >> > > We are all integrants of  an Academic Research Group of Universidad
> > >> > > Nacional de Colombia - Bogota, working in Design of embedded Systems
> > >> and
> > >> > > HW-SW Codesing.
> > >> > >
> > >> > > It's really exciting for us, Help to  Qi-Hardware project/people,
> > >> > > contribute to the project and Developer's Community. As a first
> > >> > > contribution, we are documenting all about basis of Hardware
> > involved
> > >> on
> > >> > > Nanonote device, topics like description, configuration and
> > operation,
> > >> > > schematics explanation, etc. You can see it at
> > >> > > http://wiki.qi-hardware.com/index.php/Hardware_basics
> > >> > >
> > >> > > Is really important to us to know What do you think about this
> > >> information,
> > >> > > with the purpose of offer to the community the best documentation
> > that
> > >> > > contributes to their work.
> > >> > >
> > >> > > So, we will waiting for your comments and suggestions to improve our
> > >> work.
> > >> > >
> > >> > > Thanks to all,
> > >> > >
> > >> > > UNAL Developer Team.
> > >> > >
> > >> > >
> > >> > >
> > >> > > _______________________________________________
> > >> > > Qi Developer Mailing List
> > >> > > Mail to list (members only): developer at lists.qi-hardware.com
> > >> > > Subscribe or Unsubscribe:
> > >> > > http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer
> > >> > >
> > >> >
> > >> >
> > >> >
> > >> > --
> > >> > Carlos Iv?n Camargo Bare?o
> > >> > Profesor Asistente
> > >> > Departamento de Ingenier?a El?ctrica y Electr?nica
> > >> > Universidad Nacional de Colombia
> > >> > cicamargoba at unal.edu.co
> > >>
> > >> > _______________________________________________
> > >> > Qi Developer Mailing List
> > >> > Mail to list (members only): developer at lists.qi-hardware.com
> > >> > Subscribe or Unsubscribe:
> > >> http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer
> > >>
> > >> -----BEGIN PGP SIGNATURE-----
> > >> Version: GnuPG v1.4.9 (GNU/Linux)
> > >>
> > >> iEYEARECAAYFAkrgVUAACgkQFShl+2J8z5UEQgCgp4SEvJUJVPv37nnrGcgzmzN+
> > >> 6ZIAmQHIBRHRsZbFNpnCdIf1XNrqBwiR
> > >> =eIU6
> > >> -----END PGP SIGNATURE-----
> > >>
> > >> _______________________________________________
> > >> Qi Developer Mailing List
> > >> Mail to list (members only): developer at lists.qi-hardware.com
> > >> Subscribe or Unsubscribe:
> > >> http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer
> > >>
> > >
> > >
> > >
> > >
> > > --
> > > Carlos Iv?n Camargo Bare?o
> > > Profesor Asistente
> > > Departamento de Ingenier?a El?ctrica y Electr?nica
> > > Universidad Nacional de Colombia
> > > cicamargoba at unal.edu.co
> > >
> >
> >
> >
> > --
> > Carlos Iv?n Camargo Bare?o
> > Profesor Asistente
> > Departamento de Ingenier?a El?ctrica y Electr?nica
> > Universidad Nacional de Colombia
> > cicamargoba at unal.edu.co
> > -------------- next part --------------
> > An HTML attachment was scrubbed...
> > URL: <
> > http://lists.qi-hardware.com/pipermail/developer/attachments/20091022/49dab775/attachment-0001.htm
> > >
> >
> > ------------------------------
> >
> > Message: 2
> > Date: Thu, 22 Oct 2009 10:06:39 -0400
> > From: Wolfgang Spraul <wolfgang at qi-hardware.com>
> > Subject: Re: Developer Team of UNAL - Colombia
> > To: "Hard- and Software Development, Kernel, Distribution,      Roadmap"
> >        <developer at lists.qi-hardware.com>
> > Message-ID: <20091022140639.GA5806 at debian>
> > Content-Type: text/plain; charset=us-ascii
> >
> > Oscar,
> > yes it is super great what you did on the wiki! Lots of documentation!
> > Thank you very much...
> >
> > Some feedback:
> >
> > I clarified the license for all content on our wiki at
> > http://wiki.qi-hardware.com/wiki/Qi_Hardware_Wiki:About
> > Basically we will follow Wikipedia and dual-license under GFDL 1.3 or later
> > and CC-BY-SA 3.0. Sorry this is a bit late but I'm sure everybody who
> > contributed so far is OK with this. If not please speak up.
> >
> > I created a weekly cron job to generate a full dump of our wiki at
> > http://downloads.qi-hardware.com/qi-wiki-dump.xml.bz2
> > Use for whatever purpose...
> >
> > Now to the content:
> >
> > There is a lot of text on pages such as the SDRAM page at
> > http://wiki.qi-hardware.com/wiki/SDRAM
> > This text looks like a general introduction into SDRAM, and links to a
> > similar (more detailed) article on Wikipedia.
> > Where does this text come from? Has it been written by you or someone from
> > your team?
> >
> > When you edit pages on the wiki, there is a note that says "You are also
> > promising us that you wrote this yourself, or copied it from a public
> > domain
> > or similar free resource. Do not submit copyrighted work without
> > permission!".
> >
> > We cannot copy and paste text from copyrighted sources such as textbooks or
> > datasheets unless the copyright owner explicitly allows us to. Pretty much
> > all
> > datasheets, including pictures or drawings in datasheets, are off-limits.
> > We need to remove all text from our wiki that was copied verbatim from
> > copyrighted sources like datasheets.
> >
> > We can copy and paste from Wikipedia, but we should define what the
> > difference between a page on the Qi wiki and a similar page on Wikipedia
> > should be.
> >
> > I modified the introduction on the homepage of our wiki a bit, to try to
> > define the purpose of our whole wiki (and thus the individual articles).
> > It now says
> > "In this wiki, we work together on articles about devices we chose to focus
> > on. How to use, program, study, repair, recycle, make changes to and
> > manufacture them. We encourage the creation of introductory and educational
> > articles that allow newcomers to dive deeper and deeper into our devices
> > as their interest or experience grows."
> >
> > Any feedback on that?
> > Wikipedia is an encyclopedia, their stated goal is that articles are
> > written
> > for a layman to be introduced to any given subject.
> > So the one thing where our articles can differ is that they provide entry
> > points into devices covered in our wiki. Lots of links to follow-on
> > resources
> > on our servers, the wiki, downloads, etc.
> > Or we write articles that are for educational or research purposes in the
> > first place, that would also differ from Wikipedia.
> >
> > About pictures and drawings:
> >
> > We cannot upload copyrighted pictures, like anything taken (scanned or
> > photographed) from datasheets. If we have uploaded such pictures, we need
> > to
> > delete them. If we make our own drawings, we should upload the original
> > file
> > that was used to create the drawing somewhere, either in the wiki or
> > downloads
> > server? Then we can upload a static PNG/JPG representation as well.
> >
> > I would say there are two groups of drawings and pictures: Things that are
> > of
> > common interest, and things that are specific to our devices.
> > For anything that is of common interest, we should upload our pictures to
> > Wikimedia Commons at
> > http://commons.wikipedia.org
> > If it's not of common interest, we add it to the Qi Hardware wiki.
> >
> > For pictures and drawings, we should take the time to add some metadata
> > about
> > the picture, such as Description, Date, Source, Author, Permission.
> > As an example here is a picture that has very complete metadata (Barack
> > Obama):
> >
> > http://commons.wikimedia.org/wiki/File:Official_portrait_of_Barack_Obama.jpg
> > If it's a drawing, 'Source' could link to the original file in the format
> > that
> > was used to do the editing.
> >
> > ---
> > OK, enough for now. I hope this is helpful, the work that was started is
> > really
> > great and several people already told me how much they like it!
> > Now we need to spend a little more effort on the copyright side so that we
> > have
> > a strong basis for the future.
> > All of this is up for discussion, I just wanted to start with some proposed
> > set
> > of guidelines. Feedback or questions very welcome...
> > Wolfgang
> >
> > On Wed, Oct 21, 2009 at 06:26:33PM -0500, Oscar Orjuela wrote:
> > > Hi everybody,
> > > We are all integrants of  an Academic Research Group of Universidad
> > Nacional
> > > de Colombia - Bogota, working in Design of embedded Systems and HW-SW
> > > Codesing.
> > >
> > > It's really exciting for us, Help to  Qi-Hardware project/people,
> > contribute
> > > to the project and Developer's Community. As a first contribution, we are
> > > documenting all about basis of Hardware involved on Nanonote device,
> > topics
> > > like description, configuration and operation, schematics explanation,
> > etc.
> > > You can see it at http://wiki.qi-hardware.com/index.php/Hardware_basics
> > >
> > > Is really important to us to know What do you think about this
> > information,
> > > with the purpose of offer to the community the best documentation that
> > > contributes to their work.
> > >
> > > So, we will waiting for your comments and suggestions to improve our
> > work.
> > >
> > > Thanks to all,
> > >
> > > UNAL Developer Team.
> >
> > > _______________________________________________
> > > Qi Developer Mailing List
> > > Mail to list (members only): developer at lists.qi-hardware.com
> > > Subscribe or Unsubscribe:
> > http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer
> >
> >
> >
> > ------------------------------
> >
> > _______________________________________________
> > Qi Developer Mailing Digest
> > Mail to list (members only): developer at lists.qi-hardware.com
> > Subscribe or Unsubscribe:
> > http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer
> >
> > End of developer Digest, Vol 4, Issue 49
> > ****************************************
> >

> _______________________________________________
> Qi Developer Mailing List
> Mail to list (members only): developer at lists.qi-hardware.com
> Subscribe or Unsubscribe: http://lists.qi-hardware.com/cgi-bin/mailman/listinfo/developer




More information about the discussion mailing list


interactive