188BET靠谱吗Scaffold - an IDE for Zotero translators

Translatorsare stored as individual JavaScript files with additional metadata at the top and tests at the bottom in the "translators" subdirectory of the188BET靠谱吗Zotero data directory.188BET靠谱吗While translators can be edited with any tool, Scaffold is dedicated to writing Zotero translators, offering advantages such as real-time testing and debugging.

Scaffold supports editing and testing web translators and import translators.Search and export translators can not yet be tested using the IDE.

Interface

188BET靠谱吗Scaffold is available via Tools → Developer → Translator Editor in Zotero.

When you first open Scaffold, you'll need to select your translator development directory.In most cases, this should be a git clone of the188BET靠谱吗Zotero translators repositoryon GitHub.

After selecting your translator directory, the main Scaffold window will open:

Top buttons

Open
Opens the "Load Translator" window.Select one of the currently installed translators, and load the translator metadata and code into Scaffold.

Save
Saves the translator you are currently working on.Provide a unique label and translator ID for your translator if you don't want to overwrite an existing translator.New translator IDs can be automatically generated via the "Generate" button.

188BET靠谱吗Save to Zotero
188BET靠谱吗Saves the translator you are currently working on and writes it to the "translators" subdirectory of the Zotero data directory, making it available to the client and Zotero Connector.(To use it in the Connector, open the Connector preferences to the Advanced tab and click Reset Translators.)

Run detect*
Saves and runs the appropriatedetectfunction:

  • If it's a web translator and a page is loaded in the Browser tab: detectWeb
  • If it's an import translator and data has been entered in the Test Data tab: detectImport
  • If it's a search translator and a JSON search object has been entered in the Test Data tab: detectSearch

Run do*
Saves and runs the appropriatedofunction of the translator code.Runs the correspondingdofunctions for the above situations, plus:

  • 188BET靠谱吗If it's an export translator and an item is selected in the main Zotero window: doExport

Tabs

Metadata
Shows the translator metadata.Translator IDs can be generated via the "Generate" button.The target regular expression can be tested with the "Test Regex" button.

Code
The text box in this tab contains the translator's JavaScript code.188BET靠谱吗The editor supports syntax highlighting, folding of code parts, search and replace, basic type inference, code suggestions, Zotero-specific hints when hovering over an item type or translator UUID string, and more.The editor also integrates ESLint, and you'll be prompted to set it up when you begin using Scaffold.

Tests
This tab contains the list of tests saved in the translator, as well as the raw JSON and expected output for each one.You can run or update tests from here.Create tests from the corresponding tab for the type of test you want to create (Browser or Test Data).

Test Data
Input data for import and search translators.

Browser
View sites and test detection and data extraction.

Debug Output

The main strength of Scaffold is its ability to provide you with immediate feedback, which can dramatically speed up translator development.After a code change, a single click suffices to run the modified translator and generate debug output.The following types of debug output can be generated:

Metadata

When the "Test Regex" button in the "Metadata" tab is clicked, the regular expression in the target field is applied to the site loaded in the Browser tab.The debug window at the right of the Scaffold window will show whether the regular expression matches (truefor a match,falsefor no match), e.g.:

09:54:11 ===>true<===(boolean)

detectWeb and doWeb

When the "Run detectWeb" button is clicked, thedetectWebfunction of the translator will be executed.Similarly, clicking the "Run doWeb" button executes the translator'sdoWebfunction.

Debug output for thedetectWebfunction shows what type of item is found on the loaded webpage, e.g.:

19:19:43 detectWeb returned type "book"

Debug output for thedoWeb188BET靠谱吗function shows all the item data that would be saved if the translator would be run by Zotero (when testing translators with Scaffold, no items are actually saved to your Zotero library), e.g.:

19:24:21 Returned item:              'itemType' => "book"              'creators' ...'0' ...'firstName' => "Herman"                      'lastName' => "Melville"                      'creatorType' => "author"              'notes' ...'tags' ...'seeAlso' ...'attachments' ...'0' ...'title' => "Google Books Link"                      'snapshot' => "false"                      'mimeType' => "text/html"                      'url' => "http://books.google.com/books?id=cYKYYypj8UAC"                      'document' => "[object]"              'date' => "1851"              'pages' => "504"              'ISBN' => "1603033742, 9781603033749"              'publisher' => "Plain Label Books"              'title' => "Moby Dick"              'repository' => "Google Books"              'complete' => function(...){...}            19:24:21 Translation successful

If runningdetectWebordoWebresults in an error, the debug window will show an error message.For debugging, additional debug output can be added to the code by adding188BET靠谱吗Zotero.debug(string);statements.

Import, Export, and Search Translators

Starting with version 6.0, Scaffold can be used to test import, export, and search translators.To test an import or search translator, enter the test data in the "Test Data" tab and use the "Run detect*" and "Run *" buttons to test the translator against the data.The output will be displayed in the right-hand pane as with web translators.188BET靠谱吗For export translators, select an item in the main Zotero window to use it for testing.

In the translator load window, import translators are arranged in alphabetical order at the bottom of the list.

Scaffold Troubleshooting

188BET靠谱吗Why does my translator work in Scaffold but not when I click the Save to Zotero button in my browser?Scaffold runs the functionsdetectWebanddoWebagainst the document in the Browser tab.In your browser, clicking the toolbar button runs the first web translator with a matchingtargetregular expression that returns a non-false value from thedetectWebfunction when run on that document andURL.

These results can differ when thetargetexpression ordetectWebconditions are too lax, which can allow embedded documents, such asiframe188BET靠谱吗s used for advertising or sharing panes, to be detected as content pages by the Zotero Connector.188BET靠谱吗To see if this is what is happening, look at the Zotero Connector's debug output for a save attempt in your browser and check theURLthat is being processed.

Why won't my attachments save?

188BET靠谱吗The output pane in Scaffold shows the item object as Zotero is about to save it.It does not in fact save the object.

Why do some fields show in the output pane but not in the created item?

As an item is saved, the contents of some fields may change.

188BET靠谱吗The attachment information in the output pane of Scaffold merely says what Zotero is going to try to save!as the attachments are saved, they may be discarded if their actual content type differs from the one specified, as can happen when PDFs or other attachments are hidden by providers behind an interstitial terms or copyright notice page.

Fields that are not allowed for the specified item type will be added to the Extra field, even if they show up in the output pane of Scaffold.

Further Reading

More detailed instructions are available atMediaWiki.These instructions may be slightly out of date.

Baidu
map