HTML Maker of Publication List in Nuclear Theory Group @ Hokkaido-U.
Last modified on Feb.14, 2007 by A. Ohnishi:
(1) General remarks
(2) Data format
(3) Usage
(4) To do
*------------------------------------------------------------------------------*
(1) General remarks
This program converts the publication data file in a specific format
to html, tex, bibtex files,
pubconv [-option]
We put an example file (example.dat), which is used to generate
the tex and html files in the annual report of our group,
http://nucl.sci.hokudai.ac.jp/WebAnnual/WebAnnual2005/index.html
Please try,
make
then you will find html files,
org.html pro.html jap.html
*------------------------------------------------------------------------------*
(2) Data format
(2.1) Basic structure of data.
%-------------------------------------------*
#EntryName
Authors;Journal;Volume;Year;Page(s);
key1: key1_contents
key2: key2_contents
key:3 key3_contents
%-------------------------------------------*
An entry start from # followed by entry name (of your choice).
Basic informations of your article
(authors, journal, volume, published year, page)
have to be given separated by ";".
I prepare several keys as shown later.
Lines start with % are ignored.
Spaces and tabs before the key and before and after the
key contents are ignored.
(2.2) Examples
(a) Minimum input for original papers.
%------------------------------------------------*
#EntryName
Authors;Journal;Volume;Year;Page(s);
title: Article Title
%------------------------------------------------*
An example.
%------------------------------------------------*
#KK2005
C. Kurokawa, K. Kat{\=o};
Phys. Rev. C;71;2005;021301(R);
title: New broad $0^+$ state in $^{12}$C
%------------------------------------------------*
For an article, title key is necessary.
(b) Internet access
%------------------------------------------------*
#INO2005
A. Isshiki, K. Naito, A. Ohnishi;
Prog. Theor. Phys.;114;2005;573-582;
title: Antisymmetrized Molecular Dynamics with Coherent State Pion
and Its Application to Excited Spectrum of $^{12}$C
Eprint: nucl-th/0407085
doi:10.1143/PTP.114.573
pdf: /~ohnishi/Src/Org/INO05.pdf
http://ptp.ipap.jp/link?PTP/114/573
%------------------------------------------------*
Keys such as, Eprint,doi,http,pdf,src, specifies
the internet source of your article.
Eprint: nucl-th/0407085 --> URL=http://arXiv.org/nucl-th/0407085
doi:10.1143/PTP.114.573 --> URL=http://dx.doi.org/10.1143/PTP.114.573
pdf: /~ohnishi/Src/Org/INO05.pdf
--> URL=/~ohnishi/Src/Org/INO05.pdf
means that is on your server.
http://ptp.ipap.jp/link?PTP/114/573
--> URL=http://ptp.ipap.jp/link?PTP/114/573
When both of doi and http are put, http is taken for the link.
(c) Minimum input for proceedings papers.
%------------------------------------------------*
#FBP04-kato
R. Suzuki, T. Myo, K. Kat{\=o};
AIP Conference Proceedings;768;2005;455;
title: Level Density in Complex Scaling method
confname: The 19th European Conference on Few-Body Problems in Physics
confcity: Groningen, Netherland
confdate: Aug. 23-27, 2004
%------------------------------------------------*
Please put conference name in the "confname" key.
"confdate" key is necessary when you want to specify the year of your talk.
For example, "pubconv -T 2005 example" picks up your talk in 2005,
even if the published year is not 2005. "confcity" key is optional.
(d) Minimum input for talks (without proceedings).
%------------------------------------------------*
#Kyoto-winter05-kato
R. Suzuki, T. Myo, Kat{\=o}$^*$;;;;;
title: Level Density of Continuum States
confname: Kyoto Winter Workshop on $\alpha$ Condensation in Nuclei
confcity: Kyoto, Japan
confdate: Feb. 22-24, 2005
%------------------------------------------------*
If you do not have proceesings, you should not put
journal-volume-year-page keys. (Please make it blank.)
(2.3) Summary of keys
Bibtex keys
title, booktitle, editor, publisher, month, address
Additional keys
For conferences
confname, confcity, confdate, confabbr
For internet access for the paper.
http, doi
For Eprint, preprint, and user-prepared sources.
Eprint, preprint, pdf, src
Other information
pubdate, note, talknum, citednum, HUDB
(2.4) Special character in tex format.
I tried to convert TeX commands to HTML format, such as
superscript, subscript, greek letters,
some math expressions and special characters.
For special characters please put them in {}, e.g., {\"a} for a-umlaut.
(2.5) Note for HUDB key. (For researchers in Hokkaido U.)
We cannot guess who you are and the Hokkaido U. database requires
where you are in the author list, and where are your collaborators belong,
in the case of collaboration work (See HU-csv.txt for detail).
6th column: Your Position, First Author(01), Second Author(02), or Other (99)
7th column: Type of Collaboration, One Dept. (01), One Univ. (02),
or Inter-Univ.(03)
HUDB key tells these information.
T. Hirano, M. Isse, Y. Nara, A. Ohnishi, K. Yoshino;
.....
HUDB:99,03
In this example, I (AO) am the fourth author, then the 6-th column should
be 99, and the collaboration extends over the world, and the 7-th column
is 03. Please add these two in the HUDB key.
*------------------------------------------------------------------------------*
(3) Usage
pubconv [-option]
converts "name.dat" to other files.
(3.1) Options
(a) Output format type: -{|l|d|h|b|c|m|a|A|}
-l: TeX type output (Default)
-d: Data type output (-o is necessary)
-h: html type output
-b: BiBTeX type output
-c: CSV output
-R: TeX reference type output
-m: Presentation Information (in TeX format)
-H: Hokudai database type CSV output
-a,A: html (Web-Annual type, a=publication, A=-at)
(b) File: -{s|o |i }: Output/Input file Selection
-i : input from input_file (dat or csv).
-o : output to output_file.
-s: output to screen
Default output is "name" + extention (tex,dat,html,bib), depending
on the format type.
(c) Flags
-{f |F |P |T }: Selecting Flag
-f: original, conference, article, invited, poster, oral,
, , , ,
-F: Rejecting Flags
Contents of the entry line, Author, Title, Journal, ... are stored
as keywords, and you can pickup those articles containing .
E.g. pubconv -f original ... : Original Papers
conference.. : Conference Proceedings
article .... : Article in Journals (incl. Proc.)
invited .... : Invited Papers
poster ..... : Poster presentation
oral ....... : Oral presentation (excl. Invited)
Other keywords are searched in Author list, Title,
journal name, volume, and year. You can specify the keyword
of that paper in the data explicitly by using & in the first
line of each entry.
#Ohnishi96t &talk &invited &byOhnishi ....
(d) Others
-P: Publication Year
-T: Talk Year
-t: oral presentation only
-j: Japanese publications only
-e: English publications only
-U: includes unpublished preprints
-E: Cut Eprint/preprint Information
-r: reverse the order of publication
-u: numbering for all
-n: add cited number information
-y: put year separator
-g: all items are selected
(3.2) Example
Picks up original English paper published in journals
and output to html file in reversed order separated by years.
pubconv -heryu -f original -F unpublished example
Picks up proceedings English paper published in journals or proceedings
and output to html file in reversed order separated by years.
pubconv -heryu -f conference -F Domestic example
Other examples are found in the Makefile.
*------------------------------------------------------------------------------*
(4) To do
I am thinking to include the converter
csv file <--> pub-data file
then it becomes more general.
2007/03/07 (ver. 1.02):
converting to csv file, and input from csv file are supported.
pubconv -c example
--> example.dat --> example.csv
pubconv -di example.csv -o example1.dat example1
--> example.csv --> example1.dat
*------------------------------------------------------------------------------*