How, exactly, do I install a new style of my own?
I obtained and edited the chicago-author-date .csl file in emacs to do something I need.
I don't know, though, how to start using it.
I could drag and drop it into Firefox, but after restarting FF and Word, Word does not see the new style.
I also was unclear what name to give the new file, and what needs to go into the material at the very top, such as name and category.
Running FF on Mac OS 10.8 with Word 2011 for Mac.
I don't know, though, how to start using it.
I could drag and drop it into Firefox, but after restarting FF and Word, Word does not see the new style.
I also was unclear what name to give the new file, and what needs to go into the material at the very top, such as name and category.
Running FF on Mac OS 10.8 with Word 2011 for Mac.
http://www.zotero.org/support/dev/citation_styles/style_editing_step-by-step
Most importantly, you want to change the id and the title of the new style. The filename doesn't matter as long as it ends in .csl.
If you want to share the style with other users on the repository (which we'd greatly appreciate), there is a longer list of requirements here: https://github.com/citation-style-language/styles/wiki/Style-Requirements
Any further problems let us know.
I hadn't seen the github wiki.
I'm still a bit confused. The chicago-author-date file I downloaded does not have an <id> field. Looking in the .csl I see a <title> field, but not an <id> field.
How do I set the <title> filed and the file name in order to play around with it on my machine for starters? And while doing that, do I need to add an <id> field?
BTW, adding the answers to my questions to the step-by-step would probably help future newbies like me.
<id>http://www.zotero.org/styles/chicago-author-date</id>
If the version of your style doesn't have such a field it's corrupted somehow.
This still doesn't tell me what I put into the ID line while I am playing with my own local copy.
Does it work to still point to the zotero styles http address for the master file when I am working on my local copy, or do I replace http:// with the appropriate file://?
There is also this: http://editor.citationstyles.org/visualEditor/
which you may find easier to use and it automates a lot of the formal stuff.
My next problem is that while I can get some of the changes I need to get closer to AAAI style, I cannot seem to move from hanging-indent entries to filled flush left and right entries.
I've tried changing the line
<bibliography hanging-indent="true" et-al-min="11" ... >
both by deleting the
hanging-indent="true"
and by changing it to
hanging-indent="false"
but either way my entries still appear with hanging indents.
Help?
As far as the visual editor goes, it seems like a nice idea that is not yet ready. I can't find anyplace using it to change the overall hanging-indent format, and it has some other problems as well.
Next 2 questions:
(1) Now that I've gotten rid of the hanging indent, is there a way to right justify bibliography entries, which is how AAAI style in fact appears?
(2) How do I tell Zotero that in this style I want all author names in the form: last-name, first-initial.
I assume the styling of author names is related to/in the code
<macro name="contributors">
<names variable="author">
<name and="text" name-as-sort-order="first" sort-separator=", " delimiter=", " delimiter-precedes-last="always"/>
<label form="short" plural="never" prefix=", "/>
<substitute>
<names variable="editor"/>
<names variable="translator"/>
<text macro="title"/>
</substitute>
</names>
<text macro="recipient"/>
</macro>
<macro name="contributors-short">
<names variable="author">
<name form="short" and="text" delimiter=", " initialize-with=". "/>
<substitute>
<names variable="editor"/>
<names variable="translator"/>
<text macro="title"/>
</substitute>
</names>
</macro>
but it's not so easy for me to figure out exactly what is what.
<name and="text" name-as-sort-order="always" initialized-with=". "
sort-separator=", " delimiter=", " delimiter-precedes-last="always"/>
see here for details: http://citationstyles.org/downloads/specification.html#name Obviously we're happy to help with small things, more generally, I would recommend taking another look at the visual editor, which I believe is much better than you give it credit for - e.g. it has info-bubbles over all items that you can modify.
Otherwise read the specs linked to above, which are an exhaustive guide to CSL.
http://citationstyles.org/downloads/specification.html
That is exactly the level of documentation that somebody like me--a programmer but utterly ignorant of .csl (because almost always Zotero already has exactly what I need or I'm writing in LaTeX with bibtex)--needs!
2. Visual editor:
If they cleaned up a few things and gave a bit of an intro it would have been a easier for me. I've finally figured out:
a. Rather than having a "save as" option under either the Style or Edit menus, where it would logically go, you're expected to go into Style Info-->Info and edit the title field.
At the very least, the "Save" warning message about clobbering the style you are working with could point to the field one needs to edit.
b. hanging-indent is located under "Advanced" rather than under Bibliography-->Layout. Advanced isn't where the newcomer is going to look on day one.
Programmer or not, of course I'd rather use a visual tool than learn a new language for something that I'm only going to do once a year if that.
https://github.com/citation-style-editor/csl-editor/wiki/User-guide-for-the-CSL-Editor
which I don't think are very good yet (e.g. they don't tell you how to save a style and change it's title.) It looks like those are editable by regular github users, so feel free to add anything you think is worthwhile (same for the step by step instructions on zotero.org, which are also in wiki form, though you need a separate wiki account).
a) true, people do struggle with the naming/saving. I think it's highly convenient that you just need to change the title and the editor does everything else for you, but it'd be a good idea to point people to that more directly.
b) that's actually not true - if you click on "bibliography" rather than bibliography-->layout - you do get to the hanging indent. Admittedly it's a bit hard to figure out where to find what - the tree on the left mirrors the structure of the XML - but for the formatting options that's not easy to solve. (Getting to other parts of the tree by clicking on relevant parts of the citation is quite elegant, but not really doable for formatting).
Did you have success coding a AAAI style file?
If so, might you be willing to share it?
Best wishes,
wbt
Cross-references:
https://forums.zotero.org/discussion/27850/style-request-aaai/
https://forums.zotero.org/discussion/10532/aaai-association-for-the-advancement-of-artificial-intelligence/
Can you please share the AAAI style file?
Either tell me the trick for uploading a file, or email me at sloan at
uic dot edu and I'll send you what I have.