From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/79037 Path: news.gmane.org!not-for-mail From: Aditya Mahajan Newsgroups: gmane.comp.tex.context Subject: Re: New module: simplebib Date: Sun, 4 Nov 2012 00:35:22 -0400 (EDT) Message-ID: References: <20121104001458.7616e428@zenlima.eu> Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; Format="flowed" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1352003738 23585 80.91.229.3 (4 Nov 2012 04:35:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 4 Nov 2012 04:35:38 +0000 (UTC) To: mailing list for ConTeXt users Original-X-From: ntg-context-bounces@ntg.nl Sun Nov 04 05:35:47 2012 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([195.12.62.10]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TUrw0-00020z-6a for gctc-ntg-context-518@m.gmane.org; Sun, 04 Nov 2012 05:35:44 +0100 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id DBFFD1024B; Sun, 4 Nov 2012 05:35:34 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id h2dDpfbB6w4E; Sun, 4 Nov 2012 05:35:32 +0100 (CET) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 2C04E101FC; Sun, 4 Nov 2012 05:35:32 +0100 (CET) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id 35F3C101FC for ; Sun, 4 Nov 2012 05:35:30 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id txrZi5KMhL8S for ; Sun, 4 Nov 2012 05:35:28 +0100 (CET) Original-Received: from filter1-til.mf.surf.net (filter1-til.mf.surf.net [194.171.167.217]) by balder.ntg.nl (Postfix) with ESMTP id 46B9A101FA for ; Sun, 4 Nov 2012 05:35:27 +0100 (CET) Original-Received: from hellskitchen.mr.itd.umich.edu (smtp.mail.umich.edu [141.211.14.82]) by filter1-til.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id qA44ZPQT023914 for ; Sun, 4 Nov 2012 05:35:26 +0100 Original-Received: FROM adi-netbook (bas3-montreal02-1096681419.dsl.bell.ca [65.94.7.203]) By hellskitchen.mr.itd.umich.edu ID 5095F08B.A9CA5.30140 ; Authuser adityam; 4 Nov 2012 00:35:23 EDT In-Reply-To: <20121104001458.7616e428@zenlima.eu> User-Agent: Alpine 2.02 (LNX 1266 2009-07-14) X-Bayes-Prob: 0.1168 (Score 0, tokens from: @@RPTN) X-CanIt-Geo: ip=141.211.14.82; country=US; region=MI; city=Ann Arbor; postalcode=48109; latitude=42.2923; longitude=-83.7145; metrocode=505; areacode=734; http://maps.google.com/maps?q=42.2923,-83.7145&z=6 X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 0RIjgzpJF - ae52421f08d0 - 20121104 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) on 194.171.167.217 X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.14 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:79037 Archived-At: On Sun, 4 Nov 2012, Zenlima wrote: > Hallo, > > here is my third module for you guys: a simple bibliography without a > database but with items: > > http://modules.contextgarden.net/simplebib > > http://wiki.contextgarden.net/Simple_Bibliography > > Please feel free to comment. I don't really understand what is the advantage of this module over the bib module (The bib module can be used without a bibtex database by writing a bibliography in a key-value way. In fact all that when you use a bibtex database, the first step is to convert the bib file to a key-value file and then proceed by processing it). Some stylistic comments: 1. Spacing around = %D \module [ %D file = t-simplebib, %D version = 0.8 %D title = \CONTEXT\ User Module, %D subtitle = Simple Bibliography, %D author = Zenlima, %D date = 2012.11.03 %D copyright = Henning Haeske, %D license = '' %D ] This will fail when you generate the documentation. Use \module[ file=t-simplebib, version=0.8, ... ] that is, no space around the = sign. 2. Use a internal namespace for macros. For example, you have \def\labelspace{\moduleparameter{simplebib}{labelSpace}} The macro \labelspace is not meant to be used by the user. So, it is better to name is \simplebib_labelspace to avoid conflict with other user defined macros. The same applies for \getparameter[tmp]. It may be better to use something like \getparamenter[simplebib_tmp_] 3. Don't use camelCase for key-values Most context keys are not camelCase. So, I would suggest "labelspace" instead of "labelSpace", "labelleft" instead of "labelLeft", etc. 4. \doifnot {...} {} vs \doifsomething {...} You can make the code slightly cleaner by using \doifsomething{...} instead of the \doifnot {...} {}. Some UI comments: 1. Dependence on crossref. Can the dependence of crossref be optional. In particular, what if a user does just wants to link to the bibliography without the funny arrows from crossref module? 2. Setting style for labels. You use \sym{...\sc{\tmplabel}....} It may be better to define style and color keys for the label rather than hardcoding \sc. In fact, all you need to do is set symstyle and symcolor for itemgroups. 3. Is it possible to change the format of an bibliographic item based on its type (journal paper, conference paper, book, etc.)? Is the current default formatting following a particular bibliographic style? If so, which one? Aditya ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://tex.aanhet.net archive : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________________