414 lines
11 KiB
JavaScript
414 lines
11 KiB
JavaScript
|
{
|
|||
|
|
"translatorID": "31659710-d04e-45d0-84ba-8e3f5afc4a54",
|
|||
|
|
"translatorType": 4,
|
|||
|
|
"label": "Twitter",
|
|||
|
|
"creator": "Bo An, Dan Stillman",
|
|||
|
|
"target": "^https?://([^/]+\\.)?(twitter|x)\\.com/",
|
|||
|
|
"minVersion": "4.0",
|
|||
|
|
"maxVersion": null,
|
|||
|
|
"priority": 100,
|
|||
|
|
"inRepository": true,
|
|||
|
|
"browserSupport": "gcsibv",
|
|||
|
|
"lastUpdated": "2024-05-24 17:20:00"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/*
|
|||
|
|
***** BEGIN LICENSE BLOCK *****
|
|||
|
|
|
|||
|
|
Twitter Translator
|
|||
|
|
Copyright © 2020-2021 Bo An, Dan Stillman
|
|||
|
|
|
|||
|
|
This file is part of Zotero.
|
|||
|
|
|
|||
|
|
Zotero is free software: you can redistribute it and/or modify
|
|||
|
|
it under the terms of the GNU Affero General Public License as published by
|
|||
|
|
the Free Software Foundation, either version 3 of the License, or
|
|||
|
|
(at your option) any later version.
|
|||
|
|
|
|||
|
|
Zotero is distributed in the hope that it will be useful,
|
|||
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|||
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|||
|
|
GNU Affero General Public License for more details.
|
|||
|
|
|
|||
|
|
You should have received a copy of the GNU Affero General Public License
|
|||
|
|
along with Zotero. If not, see <http://www.gnu.org/licenses/>.
|
|||
|
|
|
|||
|
|
***** END LICENSE BLOCK *****
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
|
|||
|
|
let titleRe = /^(?:\(\d+\) )?(.+) .* (?:Twitter|X): .([\S\s]+). \/ (?:Twitter|X)/;
|
|||
|
|
let domainRe = /https?:\/\/(?:www\.)?([^/]+)+/;
|
|||
|
|
|
|||
|
|
function detectWeb(doc, url) {
|
|||
|
|
if (url.includes('/status/')) {
|
|||
|
|
return "forumPost";
|
|||
|
|
}
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function unshortenURLs(doc, str) {
|
|||
|
|
var matches = str.match(/https?:\/\/t\.co\/[a-z0-9]+/gi);
|
|||
|
|
if (matches) {
|
|||
|
|
for (let match of matches) {
|
|||
|
|
let url = unshortenURL(doc, match);
|
|||
|
|
// Replace t.co URLs (with optional query string, such as "?amp=1")
|
|||
|
|
// in text with real URLs
|
|||
|
|
str = str.replace(new RegExp(ZU.quotemeta(match) + '(\\?\\w+)?'), url);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
return str;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function unshortenURL(doc, tCoURL) {
|
|||
|
|
var a = doc.querySelector('a[href*="' + tCoURL + '"]');
|
|||
|
|
if (!a || !domainRe.test(a.textContent)) {
|
|||
|
|
return tCoURL;
|
|||
|
|
}
|
|||
|
|
return a.textContent.replace(/…$/, '');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function extractURLs(doc, str) {
|
|||
|
|
var urls = [];
|
|||
|
|
var matches = str.match(/https?:\/\/t\.co\/[a-z0-9]+/gi);
|
|||
|
|
if (matches) {
|
|||
|
|
for (let match of matches) {
|
|||
|
|
urls.push(unshortenURL(doc, match));
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
return urls;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// Find the link to the permalink (e.g., "8h")
|
|||
|
|
function findPermalinkLink(doc, canonicalURL) {
|
|||
|
|
let path = canonicalURL.match(/https?:\/\/[^/]+(.+)/)[1];
|
|||
|
|
return doc.querySelector(`a[href="${path}" i]`);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function doWeb(doc, url) {
|
|||
|
|
scrape(doc, url);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
function scrape(doc, url) {
|
|||
|
|
var item = new Zotero.Item("forumPost");
|
|||
|
|
|
|||
|
|
var canonicalURL = doc.querySelector('link[rel="canonical"]').href;
|
|||
|
|
// For unclear reasons, in some cases the URL doesn't have capitalization
|
|||
|
|
// but rel="canonical" does, and in other cases it's the other way around,
|
|||
|
|
// so if rel="canonical" doesn't have any caps, use the URL
|
|||
|
|
if (!/[A-Z]/.test(canonicalURL)) {
|
|||
|
|
canonicalURL = url.match(/^([^?#]+)/)[1];
|
|||
|
|
}
|
|||
|
|
var originalTitle = doc.title;
|
|||
|
|
var unshortenedTitle = ZU.unescapeHTML(unshortenURLs(doc, originalTitle));
|
|||
|
|
// Extract tweet from "[optional count] [Display Name] on Twitter: “[tweet]”"
|
|||
|
|
var matches = unshortenedTitle.match(titleRe);
|
|||
|
|
var [, author, tweet] = matches;
|
|||
|
|
|
|||
|
|
// Title is tweet with newlines removed
|
|||
|
|
item.title = tweet.replace(/\s+/g, ' ');
|
|||
|
|
|
|||
|
|
// Don't set short title when tweet contains colon
|
|||
|
|
item.shortTitle = false;
|
|||
|
|
|
|||
|
|
// Identify the tweet block by looking for the client link (e.g, "Tweetbot")
|
|||
|
|
var articleEl;
|
|||
|
|
var clientLink = doc.querySelector('a[href*="source-labels"]');
|
|||
|
|
if (clientLink) {
|
|||
|
|
articleEl = clientLink.closest('article');
|
|||
|
|
}
|
|||
|
|
// If client link not found, use permalink
|
|||
|
|
//
|
|||
|
|
// This is the case on share URLs such as
|
|||
|
|
// https://twitter.com/aerospacecorp/status/1391160460150382598?s=27,
|
|||
|
|
// but that doesn't serve content to the test runner for some reason, so
|
|||
|
|
// we don't have a test for it.
|
|||
|
|
else {
|
|||
|
|
let a = findPermalinkLink(doc, canonicalURL);
|
|||
|
|
articleEl = a.closest('article');
|
|||
|
|
}
|
|||
|
|
var tweetSelector = 'article[role="article"]';
|
|||
|
|
|
|||
|
|
// If the title is modified (e.g., because we stripped newlines), add the
|
|||
|
|
// full tweet in Abstract.
|
|||
|
|
//
|
|||
|
|
// Same if it's a quote tweet, since the quoted tweet isn't included in the
|
|||
|
|
// title. It would be better to just get the tweet URL, but that doesn't
|
|||
|
|
// seem to be available on the page.
|
|||
|
|
//
|
|||
|
|
// DEBUG: 'role*=blockquote' doesn't seem to be used anymore, so there
|
|||
|
|
// doesn't seem to be a good way to get the contents of the quoted tweet
|
|||
|
|
let blockquote = articleEl.querySelector(`${tweetSelector} div[role*=blockquote]`);
|
|||
|
|
if (tweet != item.title || blockquote) {
|
|||
|
|
let note = ZU.text2html('“' + tweet + '”');
|
|||
|
|
if (blockquote) {
|
|||
|
|
note += '<blockquote>'
|
|||
|
|
+ ZU.text2html(blockquote.innerText.replace(/[\s]+/g, ' ').trim())
|
|||
|
|
+ "</blockquote>";
|
|||
|
|
}
|
|||
|
|
item.notes.push({ note });
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
item.language = attr(articleEl, 'div[lang]', 'lang');
|
|||
|
|
|
|||
|
|
item.creators.push({
|
|||
|
|
lastName: `${author} [@${canonicalURL.split('/')[3]}]`,
|
|||
|
|
fieldMode: 1,
|
|||
|
|
creatorType: 'author'
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// Date and time
|
|||
|
|
var spans = articleEl.querySelectorAll(`${tweetSelector} a span`);
|
|||
|
|
for (let span of spans) {
|
|||
|
|
// Is this used in all locales?
|
|||
|
|
let dotSep = ' · ';
|
|||
|
|
let str = span.textContent;
|
|||
|
|
if (!str.includes(dotSep)) {
|
|||
|
|
// Z.debug("Date separator not found")
|
|||
|
|
|
|||
|
|
// Share URLs don't show the date, so use the <time> in the
|
|||
|
|
// permalink link
|
|||
|
|
//
|
|||
|
|
// E.g., https://twitter.com/aerospacecorp/status/1391160460150382598?s=27
|
|||
|
|
let a = findPermalinkLink(doc, canonicalURL);
|
|||
|
|
if (a) {
|
|||
|
|
let time = a.querySelector('time');
|
|||
|
|
if (time) {
|
|||
|
|
let dt = time.getAttribute('datetime');
|
|||
|
|
item.date = dt.replace(/:\d\d\.000/, '');
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
continue;
|
|||
|
|
}
|
|||
|
|
let [time, date] = str.split(dotSep);
|
|||
|
|
item.date = ZU.strToISO(date);
|
|||
|
|
|
|||
|
|
time = time.trim();
|
|||
|
|
let matches = time.match(/^([0-9]{1,2})[:h]([0-9]{2})(?: (.+))?$/);
|
|||
|
|
if (matches) {
|
|||
|
|
let hour = matches[1];
|
|||
|
|
let minute = matches[2];
|
|||
|
|
let ampm = matches[3];
|
|||
|
|
// If "PM", add 12 hours
|
|||
|
|
if (ampm && ampm.toLowerCase() == 'pm' && hour != "12") {
|
|||
|
|
hour = parseInt(hour) + 12;
|
|||
|
|
}
|
|||
|
|
// Convert to UTC and add 'T' and 'Z'
|
|||
|
|
let isoDate = item.date + 'T' + ("" + hour).padStart(2, '0') + ':' + minute;
|
|||
|
|
isoDate = new Date(isoDate).toISOString();
|
|||
|
|
item.date = isoDate.replace(/:00\.000/, '');
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
item.forumTitle = "Twitter";
|
|||
|
|
item.postType = "Tweet";
|
|||
|
|
item.url = canonicalURL;
|
|||
|
|
|
|||
|
|
/*
|
|||
|
|
// Add retweets and likes to Extra
|
|||
|
|
let retweets;
|
|||
|
|
let likes;
|
|||
|
|
let str = text(articleEl, 'a[href*="retweets"]');
|
|||
|
|
if (str) {
|
|||
|
|
// Extract from "123 Retweets", "1.2K Retweets"
|
|||
|
|
str = str.match(/^[^ ]+/);
|
|||
|
|
if (str) {
|
|||
|
|
retweets = str[0];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
str = text(articleEl, 'a[href*="likes"]');
|
|||
|
|
if (str) {
|
|||
|
|
str = str.match(/^[^ ]+/);
|
|||
|
|
if (str) {
|
|||
|
|
likes = str[0];
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
if (!item.extra) {
|
|||
|
|
item.extra = '';
|
|||
|
|
}
|
|||
|
|
if (retweets) {
|
|||
|
|
item.extra += 'Retweets: ' + retweets;
|
|||
|
|
}
|
|||
|
|
if (likes) {
|
|||
|
|
item.extra += '\n' + 'Likes: ' + likes;
|
|||
|
|
}
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
item.attachments.push({
|
|||
|
|
document: doc,
|
|||
|
|
title: "Snapshot"
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
// Add links to any URLs
|
|||
|
|
var urls = extractURLs(doc, originalTitle);
|
|||
|
|
for (let i = 0; i < urls.length; i++) {
|
|||
|
|
let url = urls[i];
|
|||
|
|
let title = "Link";
|
|||
|
|
// Number links if more than one
|
|||
|
|
if (urls.length > 1) {
|
|||
|
|
title += " " + (i + 1);
|
|||
|
|
}
|
|||
|
|
// Include domain in parentheses
|
|||
|
|
let domain = url.match(domainRe)[1];
|
|||
|
|
if (domain != 't.co') {
|
|||
|
|
title += ` (${domain})`;
|
|||
|
|
}
|
|||
|
|
item.attachments.push({
|
|||
|
|
url,
|
|||
|
|
title,
|
|||
|
|
mimeType: "text/html",
|
|||
|
|
snapshot: false
|
|||
|
|
});
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
item.complete();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/** BEGIN TEST CASES **/
|
|||
|
|
var testCases = [
|
|||
|
|
{
|
|||
|
|
"type": "web",
|
|||
|
|
"url": "https://twitter.com/zotero/status/105608278976905216",
|
|||
|
|
"defer": true,
|
|||
|
|
"items": [
|
|||
|
|
{
|
|||
|
|
"itemType": "forumPost",
|
|||
|
|
"title": "Zotero 3.0 beta is now available with duplicate detection and tons more. Runs outside Firefox with Chrome or Safari! http://zotero.org/blog/announcing-zotero-3-0-beta-release/",
|
|||
|
|
"creators": [
|
|||
|
|
{
|
|||
|
|
"lastName": "Zotero [@zotero]",
|
|||
|
|
"fieldMode": 1,
|
|||
|
|
"creatorType": "author"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"date": "2011-08-22T11:52Z",
|
|||
|
|
"forumTitle": "Twitter",
|
|||
|
|
"language": "en",
|
|||
|
|
"postType": "Tweet",
|
|||
|
|
"url": "https://twitter.com/zotero/status/105608278976905216",
|
|||
|
|
"attachments": [
|
|||
|
|
{
|
|||
|
|
"title": "Snapshot",
|
|||
|
|
"mimeType": "text/html"
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"title": "Link (zotero.org)",
|
|||
|
|
"mimeType": "text/html",
|
|||
|
|
"snapshot": false
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"tags": [],
|
|||
|
|
"notes": [],
|
|||
|
|
"seeAlso": []
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"type": "web",
|
|||
|
|
"url": "https://twitter.com/zotero/status/1037407737154596864",
|
|||
|
|
"defer": true,
|
|||
|
|
"items": [
|
|||
|
|
{
|
|||
|
|
"itemType": "forumPost",
|
|||
|
|
"title": "Zotero, Mendeley, EndNote. You have a lot of choices for managing your research. Here’s why we think you should choose Zotero. https://t.co/Qu2g5cGBGu",
|
|||
|
|
"creators": [
|
|||
|
|
{
|
|||
|
|
"lastName": "Zotero [@zotero]",
|
|||
|
|
"fieldMode": 1,
|
|||
|
|
"creatorType": "author"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"date": "2018-09-05T18:30Z",
|
|||
|
|
"forumTitle": "Twitter",
|
|||
|
|
"language": "en",
|
|||
|
|
"postType": "Tweet",
|
|||
|
|
"url": "https://twitter.com/zotero/status/1037407737154596864",
|
|||
|
|
"attachments": [
|
|||
|
|
{
|
|||
|
|
"title": "Snapshot",
|
|||
|
|
"mimeType": "text/html"
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"title": "Link",
|
|||
|
|
"mimeType": "text/html",
|
|||
|
|
"snapshot": false
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"tags": [],
|
|||
|
|
"notes": [],
|
|||
|
|
"seeAlso": []
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"type": "web",
|
|||
|
|
"url": "https://twitter.com/zotero/status/1105581965405757440",
|
|||
|
|
"defer": true,
|
|||
|
|
"items": [
|
|||
|
|
{
|
|||
|
|
"itemType": "forumPost",
|
|||
|
|
"title": "You don’t have to send students to a site that will spam them with ads or try to charge them money just to build a bibliography. Instead, tell them about ZoteroBib, the free, open-source, privacy-protecting bibliography generator from Zotero. https://zbib.org",
|
|||
|
|
"creators": [
|
|||
|
|
{
|
|||
|
|
"lastName": "Zotero [@zotero]",
|
|||
|
|
"fieldMode": 1,
|
|||
|
|
"creatorType": "author"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"date": "2019-03-12T21:30Z",
|
|||
|
|
"forumTitle": "Twitter",
|
|||
|
|
"language": "en",
|
|||
|
|
"postType": "Tweet",
|
|||
|
|
"url": "https://twitter.com/zotero/status/1105581965405757440",
|
|||
|
|
"attachments": [
|
|||
|
|
{
|
|||
|
|
"title": "Snapshot",
|
|||
|
|
"mimeType": "text/html"
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"title": "Link (zbib.org)",
|
|||
|
|
"mimeType": "text/html",
|
|||
|
|
"snapshot": false
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"tags": [],
|
|||
|
|
"notes": [],
|
|||
|
|
"seeAlso": []
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
},
|
|||
|
|
{
|
|||
|
|
"type": "web",
|
|||
|
|
"url": "https://twitter.com/DieZeitansage/status/958792005034930176",
|
|||
|
|
"defer": true,
|
|||
|
|
"items": [
|
|||
|
|
{
|
|||
|
|
"itemType": "forumPost",
|
|||
|
|
"title": "Es ist 21:00 Uhr.",
|
|||
|
|
"creators": [
|
|||
|
|
{
|
|||
|
|
"lastName": "Zeitansage [@DieZeitansage]",
|
|||
|
|
"fieldMode": 1,
|
|||
|
|
"creatorType": "author"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"date": "2018-01-31T20:00Z",
|
|||
|
|
"forumTitle": "Twitter",
|
|||
|
|
"language": "de",
|
|||
|
|
"postType": "Tweet",
|
|||
|
|
"url": "https://twitter.com/DieZeitansage/status/958792005034930176",
|
|||
|
|
"attachments": [
|
|||
|
|
{
|
|||
|
|
"title": "Snapshot",
|
|||
|
|
"mimeType": "text/html"
|
|||
|
|
}
|
|||
|
|
],
|
|||
|
|
"tags": [],
|
|||
|
|
"notes": [],
|
|||
|
|
"seeAlso": []
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
}
|
|||
|
|
]
|
|||
|
|
/** END TEST CASES **/
|