| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| dev:how_to_write_a_zotero_translator_2nd_edition [2017/03/19 13:03] – [Table of Contents] update to be friendlier owcz | dev:how_to_write_a_zotero_translator_2nd_edition [2017/11/22 11:15] (current) – Remove outdated translator info bwiernik |
|---|
| ====== How to Write a Zotero Translator, 2nd Edition ====== | **Note:** This page used to hold an updated version of Adam Crymble's [[http://niche-canada.org/member-projects/zotero-guide/chapter1.html|How to Write a Zotero Translator]]. The guidance included in both Adam's original guide and this update is too outdated to be useful and translators based on it are no longer accepted. We instead recommend the following resources: |
| |
| **Note**: This guide's advice on translator code [[https://github.com/zotero/translators/pull/1282#issuecomment-287574730|may be outdated]]. Instead, model your code on [[https://github.com/zotero/translators/pulls|recently updated translators]], [[https://github.com/zuphilip/translators/wiki/Common-code-blocks-for-translators|common code templates]], [[https://www.zotero.org/support/dev/translators/coding|the translator coding documentation]], and search for answers in the [[https://forums.zotero.org/discussions|Zotero Forums]] and [[https://github.com/zotero/translators/issues|on GitHub]]. | * The template code included in [[https://www.zotero.org/support/dev/translators/scaffold|Scaffold]], |
| | * The code of [[https://github.com/zotero/translators/pulls|recently updated translators]], |
| ===== Table of Contents ===== | * The documentation for writing Zotero translators by [[https://www.mediawiki.org/wiki/Citoid/Creating_Zotero_translators|Wikimedia]], the most comprehensive and up-to-date resource for writing "scrapers" as of November 2017, |
| | * The [[https://www.zotero.org/support/dev/translators/coding|translator coding documentation]], |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 1|Chapter 1: Introduction]] | * Search for answers in the [[https://forums.zotero.org/discussions|Zotero Forums]] and [[https://github.com/zotero/translators/issues|on GitHub]]. |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 2|Chapter 2: General Troubleshooting Guidelines]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 3|Chapter 3: Required Software (all free)]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 4|Chapter 4: The DOM & HTML]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 5|Chapter 5: XPaths (Directions)]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 6|Chapter 6: JavaScript Basics & Variables]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 7|Chapter 7: JavaScript Methods & Math]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 8|Chapter 8: JavaScript If Statements]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 9|Chapter 9: JavaScript Loops]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 10|Chapter 10: JavaScript Functions]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 11|Chapter 11: XPath Objects (Containers)]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 12|Chapter 12: Regular Expressions]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 13|Chapter 13: Scaffold Metadata Tab]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 14|Chapter 14: Scaffold DetectWeb Tab]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 15|Chapter 15: Scraping the Search Results Page: doWeb Function]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 16|Chapter 16: Scraping the Individual Entry Page: Scrape Function]] | |
| * [[dev/How to Write a Zotero Translator, 2nd Edition/Chapter 17|Chapter 17: Common Problems when Scraping an Individual Entry Page]] | |
| | |
| This tutorial is an adaptation of '[[http://niche-canada.org/zotero-guide|How to Write a Zotero Translator]]' (2009) by Adam Crymble. The 2nd Edition has been created to bring the tutorial up-to-date with Zotero 2.x translator development. | |
Upgrade Storage