Standalone can't download citations
Information on this issue is conflicting, or at least seems so to the uninitiated. aurimas says in thread https://forums.zotero.org/discussion/27013/using-zotero-on-different-computers/ that if using standalone you _still_ need to have the FF extension installed in the browser. However, ChristineAmor in thread https://forums.zotero.org/discussion/28845/no-zotero-icons-in-browser-window-since-firefox-20-upgrade/ says she was using standalone (apparently without the FF extension, though she doesn't clarify the matter) to download citations until it stopped working just last week. In addition, adamsmith in thread https://forums.zotero.org/discussion/21623/ says, "Zotero for Firefox still works better to get data from sites. The biggest issue is that the connectors cannot, to the best of my knowledge, properly deal with library proxies, so automatically downloading pdfs and gated full text articles won't work in standalone (that includes, I believe standalone used with Firefox in Connector mode). Also, you don't have some options in the connectors (like Create note and new item from current page) that you have in Zotero FF." (I'm assuming that "Connector Mode" and connectors are different from normal site translators--"Connector Mode" is fairly new and unfamiliar to me, and no mention of it can be found on http://www.zotero.org/support/getting_stuff_into_your_library.)
There, by saying that the FF extension "still works better to get data from sites" rather than that it is "the only solution to get data from sites", adamsmith implies that automatically downloading a plain, vanilla text citation should work fine in standalone; it's just the bells and whistles such as PDFs--which I almost never use--that don't, unless "new item from current page" means a standard bibliographical citation. Which it may, since adamsmith also says to a standalone user in thread https://forums.zotero.org/discussion/28944/zotero-no-longer-sensing-information/#Item_0, "install the firefox add-on from zotero.org/download - I don't know how you'd ever have gotten icons without it."
So once and for all, what's the deal here? Can standalone download citations without the FF extension, or not?
There, by saying that the FF extension "still works better to get data from sites" rather than that it is "the only solution to get data from sites", adamsmith implies that automatically downloading a plain, vanilla text citation should work fine in standalone; it's just the bells and whistles such as PDFs--which I almost never use--that don't, unless "new item from current page" means a standard bibliographical citation. Which it may, since adamsmith also says to a standalone user in thread https://forums.zotero.org/discussion/28944/zotero-no-longer-sensing-information/#Item_0, "install the firefox add-on from zotero.org/download - I don't know how you'd ever have gotten icons without it."
So once and for all, what's the deal here? Can standalone download citations without the FF extension, or not?
To enable automatic imports, you have to install a browser-specific extension (i.e. Connector) - Chrome, Safari, or Firefox. Chrome and Safari connectors are relatively primitive and serve only to import citations from the web browser to Zotero Standalone. The Firefox extension is the full-fledged Zotero and can perform a lot more functions (in addition to helping Zotero Standalone communicate with Firefox). One of the advantages of being completely integrated into the browser is that it can in some cases import better metadata and/or attachments. Also, being integrated into the browser, Zotero Firefox extension can redirect your browsing automatically through a proxy.
So to answer your question, Standalone on its own cannot do one-click downloading of citations from your browser. You have to install a connector (Safari, Chrome) or the Firefox extension (which will act as a connector when Standalone is open) in order to have the URL button show up.
First, the user encounters the "Standalone" moniker. What does "Standalone" imply? That the item is complete, fully functional within itself, requiring nothing else for its use. Let's repeat: requiring NOTHING else. Then what does the user read? "Zotero Standalone runs as a separate application and plugs into your choice of browser." It does not say "Zotero Standalone runs as a separate application and plugs into your choice of browser, but will integrate with Firefox only with an addon"; no, nothing nice and clear like that. Instead, the reader simply finds that it "runs as a separate application and plugs into your choice of browser", period, end of story. Acting in concert with the designation "Standalone", that sentence strongly implies that ZSA contains, by itself, all the capabilities of the FF extension.
That's rather the opposite of "clear as possible." If you truly want to be clear about this, you need to revise the sentence on the download page along the lines I laid out above, or make it even more obvious by adding another sentence, something like, "WARNING: Zotero standalone cannot download citations or other materials directly from web pages. If you need this functionality, you must add it by installing the Zotero Firefox extension."
You may be counting on the words "plug into" to evoke an association with browser plugins, which are separate entities, to clue in the reader that something else is necessary for ZSA. If so you're both colloquially and technically inaccurate. In colloquial terms, "plug into" doesn't imply the need for any assistance: while an electrical engineer might see things a bit differently, an end user sees the cord of an appliance as an integral part of that appliance, so plugging the appliance into the wall socket does not require any other item--the appliance "plugs into your choice of" wall socket, complete in itself as that action is performed. Therefore "plugs into" will fail to raise any flags at all with the non-tekkie downloader. And the phrase is also misleading in a strictly technical sense because Firefox plugins are a different kind of coded entity from Firefox extensions, so technically-aware users would think not of installing the Firefox extension but rather a plugin; and when no plugin is to be found, they will resort to interpreting the phrase in the colloquial sense, giving Zotero developers the benefit of the doubt rather than suspecting them of having used inaccurate technical terminology.
You should also consider changing the "Standalone" designation. On this issue, aurimas's diction is unhappily accurate: "being a standalone application, Zotero cannot perform one of its most important functions". The paradoxical nature of his phrasing ought to be clear--something is obviously wrong when an app designated as "standalone" can't do one of its "most important" tasks without aid. In other words, Zotero "Standalone" cannot, in fact, stand alone; the designation is not merely unmerited but misleading. Unless the fairly near future (say, within two years) will add the web-page integration, in which case you have the excuse of just jumping the gun with the name, you should replace "Standalone" with some such designation as "Zotero Database", advertising it as one component of the full package--a component which simply happens to be installable without the whole enchilada, unlike other components--rather than a full package in and of itself. That ZSA is clearly not, as aurimas's phrasing all too clearly reveals.
I've gone on at length about this because I did my due-diligence RTFMing in the regular documentation prior to installing Standalone. There is also nothing clear concerning this issue on http://www.zotero.org/support/getting_stuff_into_your_library , which is the other place one would expect it to be; the single mention of Standalone is in the "Web Page" section, and most other sections--and especially the section of overriding importance, that of adding regular items--simply talk about "Zotero", with no caveat that it really means only the FF extension and excludes Standalone. Sorry, but again, that's about as clear as five-inch-thick mud. It's no use to RTFM when the FM doesn't repay the R. I love Zotero and the work you do on it--no complaints about the app. Keep up the good work. But do please prevent other users from enduring their own two-odd-hour mini-saga poking about forums to answer a question that should indeed have been clearly answered on the download page.
I agree the documentation isnt' very good about Standalone, but someone needs to write documentation - it's a lot of work, it's not the most thankful of tasks and labor is scarce: it's a wiki, so do consider contributing.
I think we should say something like "First download Zotero Standalone" and "Then install a plugin for your browser". This would reduce confusion where people do not download standalone and it would make it more obvious that a browser plugin is required.
Zotero Standalone runs as a separate application
[Download ZSA link]
and plugs into your choice of browser via one of these plugins:
[Download links for connectors & ZFF]
maybe also add link to bookmarklet which is otherwise impossible to find?
(My concern about "first... then.." is that it may confuse people who already have one of the two installed - there is obviously no required order of doing this)
re wording, I do think that we should be as direct and straight to the point as possible. instead of implying that the user should download the plugin, we should just say that they should do it.
Install both...
and...
That said, I'd personally like to see at least twitter announcements of every new version, maybe that could even be automated.
I agree that it would be nice to have a link to the Changelog - IIRC fcheslack has concerns about including too many links. System requirements is another one that gets requested a fair amount.
Anyhow, I think Simon is planning to add a first-run feature at some point that would either automatically install bundled browser extensions or send you to the appropriate page to do so. So in that sense, the browser extension links are a temporary solution. (As aurimas says, though, you're still misunderstanding the term "Standalone", which is about its relation to the original Firefox extension, not about its own capabilities. It's certainly not the best name, but as long as we offer both (and there are still many more Zotero for Firefox users) there aren't a whole lot of great alternatives. If anything, the common perception is that Zotero is still just a Firefox extension.)
We should also have a documentation page that goes into a bit more depth about the differences between the two versions, which, when it comes to translator compatibility, proxy functionality, and direct-to-server saving, are certainly subtle and confusing. I could see having a "Not sure which one to choose?" link to that on the download page.
In the meantime, regarding wording, instead of "Add one of the following browser extensions:", I could maybe see "Add the extension for your browser:" as being a little more direct.
If rewording can reduce that number further - why not? If you think the current wording is good in general, just moving the "plugs into" part to below the download button would already help. Or go for Aurimas's or my more direct: Install both... version.
I agree about the "Not sure which one" link, but doing that well will take some thought/time.
So the part before the extensions:
How about
"It requires one of the these browser extensions:"
or do you find that too strong?
Is "Add the extension for your browser:" not direct, in combination with the line above?
"Be sure to add the extension for your browser:"
"Be sure to add a browser extension:"
"Be sure to add one or more browser extensions:"
edit: to me at least the "be sure" actually makes this seem less of a requirement. As in "be sure to check out our sales items in aisle 10" -
Alternatively (or in conjunction), we could add a "download" arrow to the image. E.g. see http://www.mozilla.org/en-US/firefox/new/ http://www.libreoffice.org/download http://www.videolan.org/vlc/index.html http://www.mendeley.com/download-mendeley-desktop/ etc. I think a green down arrow would look nice.
1. Download and install Zotero Standalone
2. Install a Zotero connector for your browser of choice
"Be sure to add one or more browser extensions"
...because I have the same reaction to just plain "Add the extension for your browser" as aurimas does to the former: makes it sound unnecessary. However, I see why aurimas associated the "be sure" version with marketing hype--it didn't strike me that way, but I can certainly understand why other folks would have that reaction. But a rephrasing of some kind is necessary: all sorts of software is available on the web with, first, a foundational app, and second, optional add-ons that only apply to certain highly specialized users. I tinker with a lot of freeware, and I find that unless I go by the if-in-doubt-don't-download rule, I end with with lots of useless clutter. Therefore the mere display of an add-on along with the foundational app simply cannot be taken to imply that the add-on is necessary for full functionality (apparently Mr. Stillman thinks otherwise, but I don't have time to argue the point further).
So I think something more emphatic is called for: "You'll need to add one or more browser extensions". (italics will be unnecessary; used here only for emphasis) Style is important, but--always assuming grammatical correctness--it should never be the major concern of technical writers. This... ...is a significant red flag. Once every three or four months would be an inconsequential trickle; but once every two weeks and sometimes more, while no torrential downpour of confusion, certainly qualifies as a steady flow that needs to be dammed. Tech-writing instructors will always tell you to err on the side of clarity even if it means clumsier prose. A fine example is the installation page, which is indeed now as clear as anyone could possibly desire. Fabulous job there, and if the flow of questions on this issue has dried up since my original post, that's where I'd place the credit. If it hasn't dried up yet, a more emphatic link to it needs to be made on the download page.
I also still think that something should be said about this on the "getting stuff into Zotero" page, a very logical place to mention the issue. I certainly looked for my answer there. Indeed, I think it's more logical than the installation page, since the functionality of Zotero's variants technically has nothing to do with the nuts and bolts of installation. If I want to know how to install, I go to the install page, but many users these days probably don't have any difficulty installing a standalone app and therefore, like me, don't bother looking at the install page. And once I'm done installing, I'll never think to look at the install page for an answer to anything because, obviously, I'm done with that process. So if I want to know why I'm unable to get citations into Zotero Standalone, it will never occur to me to look at the install page; instead, I'll go to "getting stuff". When the dissertation is done (may that day someday come) maybe I'll jump in and have a go at that one myself.
Also, we should add a plus graphic to the connector download buttons: http://www.clker.com/clipart-green-plus.html
And we need to add Opera as a connector choice and link it to https://addons.opera.com/en/extensions/details/zotero-connector/
That might make it obvious enough that both components can/need to be downloaded. The only other change I would make then, is to change "Add one of the following browser extensions:" to "And add one of the following browser extensions:" (since there was some objection to using "then") I agree with this. Will see how to incorporate the link.
But we do need to add the link to installation instructions page from the download page.
http://www.zotero.org/support/getting_stuff_into_your_library#web_translators