CiteIt.net https://www.citeit.net a higher standard of citation Thu, 29 Oct 2020 03:50:12 +0000 en-US hourly 1 https://wordpress.org/?v=5.5.1 https://www.citeit.net/wp-content/uploads/2018/05/cropped-favicon-32x32.png CiteIt.net https://www.citeit.net 32 32 Wikipedia Project https://www.citeit.net/2020/10/24/wikipedia-project/ https://www.citeit.net/2020/10/24/wikipedia-project/#respond Sat, 24 Oct 2020 18:08:52 +0000 https://www.citeit.net/?p=2300 CiteIt’s Contextual Citations are a natural addition to Wikipedia. Wikipedia already has popup windows which show more information about linked articles. These popups appear whenever a reader mouses over an article name (see Los Angeles Lakers example to the right) Contextual Citations would be similar to contextual article popups. – a popup would appear to […]

The post Wikipedia Project appeared first on CiteIt.net.

]]>

CiteIt’s Contextual Citations are a natural addition to Wikipedia.

Wikipedia already has popup windows which show more information about linked articles.

  • These popups appear whenever a reader mouses over an article name (see Los Angeles Lakers example to the right)
  • Contextual Citations would be similar to contextual article popups. — a popup would appear to provide more context about a quotation — but they would only appear when a reader clicks on the quotation, not on mouseover.
  • The data for these contextual citations would be pulled from the original source when the Wikipedia author publishes the article.

 

Wikipedia Contextual Citations

Below are mockups of a few sample articles that demonstrate what Wikipedia would look like if it used CiteIt.net’s proposed Contextual Citations.

People/Groups

  1. Ruth Bader Ginsburg
  2. Hillary Clinton
  3. Donald Trump

Literature

  1. Pride and Prejudice
  2. Hamlet

History

  1. Inauguration of John F. Kennedy
  2. 2000_MI6_attack

Science

  1. Manned Orbiting Laboratory
  2. Syphilis

Screenshot

Below is a screenshot of the Ruth Bader Ginsburg article mockup which shows the Contextual Popup that appears when a reader clicks on the light grey-blue text of a contextual quotation, in this case: “Ginsburg precedent“.

The Contextual Popup displays the 500 characters before and after the quote. In this instance, the quote is from a 2005 New York Times article.

Proposal for Wikipedia Editor

On the Wikipedia technical end, I’ve also written up a proposal describing the technical changes that would need to be made to Wikipedia’s editor to allow links to be specified with blockquote and q tags.

 

Converting Existing Wikipedia articles

I assume that the first Wikipedia article’s citations would be manually marked up with hand-coding or the using the editor, but that eventually, the goal would be to automate the process of converting existing citations to CiteIt’s Contextual Citations.

Test Cases

This list of a few of the issues that could could be converted into a test suite that is used in development.

Category Class Description Example Color
Error citeit-error-context Context is Returned, but Incorrect Example:

convention’s “veiled” racist messages

#ff3399
Error citeit-error-quote-returned Error in Returned Quote Quote:

Clinton asserted President Trump’s 2018 budget proposal was “a con” for underfunding domestic programsReturned: Clinton called Mr. Trump’s 2018 budget proposal ” a cong ” which she said would underfund public education

red
Error citeit-error-quote-context-edges Slight character errors in Surrounding Context Example:

“adding that her mother Dorothy “made sure I learned [these] words from our Methodist faith” Quote: “And she made sure I learned [these] ds from our Methodist faith”

red
PDF citeit-pdf-scanned Source Document is a PDF image that needs to be scanned with OCR Example:

memorandum saying “the data indicates that the President remains healthy.

HTML:

memorandum saying “<q cite=”https://media.arkansasonline.com/news/documents/2020/06/03/Trump_Physical_Exam.pdf” class=”citeit-pdf-scanned”>the data indicates that the President remains healthy.

#0099ff
Match citeit-footnote-shortname Footnote is a short form of citation. The program needs to Need to cross-reference the short name with the longer reference in the references cited section. The footnote is listed in the short form: Lastname, page

Example:

Troy 2006, pp. 176–77

References cited:

Troy, Gil (2006). Hillary Rodham Clinton: Polarizing First Lady. Lawrence, Kansas: University Press of Kansas. ISBN 978-0-7006-1488-2.

red
Wiki citeit-footnote-later The match is not found in the first footnote, but in a second footnote. Quote:

“In July 2016, she “committed” to introducing a U.S. constitutional amendment” 1st Source: not found 1st Source URL: http://www.cnn.com/2016/07/16/politics/hillary-clinton-campaign-finance/2nd

Footnote 1:

Merica, Dan (July 16, 2016). “Clinton: I will introduce campaign finance amendment in first 30 days”. also see 2 1/2-minute video: CNN. Retrieved July 17, 2016.

Footnote 2:

Oreskes, Benjamin (July 16, 2016). “Clinton pledges constitutional amendment to overturn Citizens United ruling”. Politico. Retrieved July 17, 2016.

Hillary Clinton committed Saturday to introducing a constitutional amendment to overturn the Citizens United decision within her first 30 days in office, if she’s elected president.

#cc6600

View Complete List of Issues

The post Wikipedia Project appeared first on CiteIt.net.

]]>
https://www.citeit.net/2020/10/24/wikipedia-project/feed/ 0
Wikipedia Citation Examples and Error Classes https://www.citeit.net/2020/10/18/wikipedia-citation-examples-and-error-classes/ https://www.citeit.net/2020/10/18/wikipedia-citation-examples-and-error-classes/#respond Mon, 19 Oct 2020 00:47:55 +0000 https://www.citeit.net/?p=2213 Wikipedia Examples Mark asked me to put together a more complete collection of Wikipedia example articles. These are a few of the articles I’ve marked up, with the goal of automating the process of converting existing quotes to Contextual Citations: People/Groups Ruth Bader Ginsburg Hillary Clinton ** Donald Trump ** Literature Pride and Prejudice Hamlet […]

The post Wikipedia Citation Examples and Error Classes appeared first on CiteIt.net.

]]>

Wikipedia Examples

Mark asked me to put together a more complete collection of Wikipedia example articles.

These are a few of the articles I’ve marked up, with the goal of automating the process of converting existing quotes to Contextual Citations:

Ruth Bader Ginsburg

Ruth Bader Ginsburg: Example Wikipedia article

People/Groups

  1. Ruth Bader Ginsburg
  2. Hillary Clinton **
  3. Donald Trump **

Literature

  1. Pride and Prejudice
  2. Hamlet

History

  1. Inauguration of John F. Kennedy
  2. 2000_MI6_attack

Science

  1. Manned Orbiting Laboratory
  2. Syphilis

 

** These articles have been completely marked up, including Books that are not available online.

 

Converting to Contextual Citations

Here’s how I imagine CiteIt.net’s Contextual Citations could be integrated with Wikipedia:

Phase 1: Manual Editing

In phase 1, citations from sample articles could be manually marked up.  This trial-run would most likely start with less high profile pages. If this were successful, Wikipedia Editors could be given the ability to mark up citations through the editor and citations could be indexed, either manually or automatically upon publication. Since most people would not know about the ability to create contextual citations using the Wikipedia editor, this phase would also be fairly low-profile.

Improving the accuracy of the returned CiteIt Context is a precondition for greater adoption.

  1. The context returned by the web service needs to be more accurate (I’ve cataloged some of the bugs below).
  2. The number of “misses” where the web service incorrectly fails to find the context needs to be reduced.
  3. The speed and scalability of the web service need to be improved.
    • Right now it takes hours to process the Donald Trump article.  The Donald Trump and Hillary Clinton articles were chosen as sample articles because they has a high number of web citations.

Phase 2: Automatic Conversion:

My friend Bryan said that it should be possible to retroactively go back and automatically convert all of Wikipedia quotes to use CiteIt’s Contextual Citations, assuming the Pareto principle that roughly 80% of the citations could be converted with a script following some straight-forward rules and the remaining citations would have to be manually processed.

With that in mind, I set out over the past month to do a fairly thorough analysis of the types of issues that we could encounter if we chose to automate the conversion. As part of the process, I would hope to create a database of citations to be “upgraded” and an interface for reporting and fixing bugs

From this database, we could both:

  • Analyze the accuracy of the program that converts quotes to Contextual Citations
  • Capture the human corrections to the program’s output

Machine Learning Option

If someone wanted to automate this process further, this process might be a good candidate for machine learning but the Wikipedia community’s philosophy towards automation and error-handling would determine how the technology is developed.

 

Analyzing Errors:

I did a more thorough job of analyzing the Hillary Clinton and Donald Trump articles, going through every quotation in the article (excluding the references at the end of the article) and marking each quote up with a q-tag and CSS classes, indicating the reason why the citation couldn’t be properly matched.

You can see highlights of all the errors if you click on the blueShow Citation Errors” button in the upper-right corner of the yellow header:

Screenshot: Show Citation Errors

 

Error Codes:

Below is a list of the CSS error classes created when marking up sample Wikipedia articles.

Category Class Description Example Color
Error citeit-automation-error An automated bot would likely pull an inappropriate match should we return multiple matches and return all results to editors or readers?

Quote:

Trump favors neutral or positive balances of trade over negative balances of trade, also known as a trade deficit”. Trump adopted his current skeptical views 

Source:

“Share of total U.S. merchandise trade deficit by country”

Explanation:  Source Returns the first result from the first footnote’s source.  But this is a legend title rather than the actual article body. It would be preferable to use a latter match.  Perhaps a UI could be built that displays all matched results and gives Wikipedia editors the ability to chose the preferred instance.

red
Error citeit-error-context Context is Returned, but Incorrect Example:  convention’s veiled” racist messages #ff3399
Error citeit-error-quote-returned Error in Returned Quote

Quote:

Clinton asserted President Trump’s 2018 budget proposal was “a con” for underfunding domestic programsReturned: Clinton called Mr. Trump’s 2018 budget proposal ” a cong “ which she said would underfund public education

red
Error citeit-error-quote-context-edges Slight character errors in Surrounding Context

Example:

“adding that her mother Dorothy “made sure I learned [these] words from our Methodist faith” Quote: “And she made sure I learned [these] ds from our Methodist faith”

red
Error citeit-error-unknown Error of Unknown Type

Example:

Emoluments Clause as phony.

HTML: Emoluments Clause as <q cite=”https://www.usatoday.com/story/news/politics/2019/10/21/donald-trump-mocks-constitution-emoluments-clause-phony/4055162002/” class=”citeit-error-unknown”>“phony”</q>

red
Error citeit-error-404 Source URL returns 404 error

Example

Clinton called for a constitutional amendment to limit “unaccountable money

red
PDF citeit-pdf-scanned Source Document is a PDF image that needs to be scanned with OCR

Example

memorandum saying “the data indicates that the President remains healthy. HTML:   memorandum saying “<q cite=”https://media.arkansasonline.com/news/documents/2020/06/03/Trump_Physical_Exam.pdf” class=”citeit-pdf-scanned”>the data indicates that the President remains healthy.

#0099ff
Match citeit-footnote-interspersed There is a footnote insterspersed in the middle of the quote that could throw off the match

Example:

Correct and consistent use of latex condoms can reduce the risk of syphilis only when the infected area or site of potential exposure is protected.[41] However, a syphilis sore outside of the area

red
Match citeit-footnote-shortname Footnote is a short form of citation. Need to cross-reference the short name with the longer reference in the references cited section.

The footnote is listed in the short form: Lastname, page

Example:

Troy 2006, pp. 176–77

References cited: Troy, Gil (2006). Hillary Rodham Clinton: Polarizing First Lady. Lawrence, Kansas: University Press of Kansas. ISBN 978-0-7006-1488-2.

red
Wiki citeit-footnote-later The match is not found in the first footnote, but in a second footnote.

Quote:

“In July 2016, she “committed” to introducing a U.S. constitutional amendment” 1st Source: not found 1st Source URL: http://www.cnn.com/2016/07/16/politics/hillary-clinton-campaign-finance/2nd Source: Hillary Clinton committed Saturday 2nd Source URL: https://www.politico.com/story/2016/07/hillary-clinton-citizens-united-225658

#cc6600
YouTube youtube-video The source is a YouTube URL Example:  “The Hillary Shimmy Song”. September 28, 2016. Retrieved September 16, 2017 – via YouTube. #3366ff
Wiki wiki-legend The Quote is found in the Legend of Wikipedia Image and the footnote may be before the quote

Example:

“Fact-checkers from The Washington Post,[839] the Toronto Star,[840] and CNN[841] compiled data on “false or misleading claims” (orange background), and “false claims” (violet foreground), respectively.”

#3366ff
Wiki wiki-note Internal Wikipedia Note

Example

Clinton into “imaginary discussions” with the also-politically active Eleanor Roosevelt.[f]

Notes:

 

f. The Eleanor Roosevelt “discussions” were first reported in 1996 by The Washington Post writer Bob Woodward; they had begun from the start of Hillary Clinton’s time as first lady.[154]

#3366ff
Wiki wiki-multiple-source Wikipedia Source Citation Record Contains Multiple Sources

Example:

Calabresi, Massimo (November 7, 2011). “Hillary Clinton and the Rise of Smart Power”. Time. pp. 26–31. See also “TIME magazine editor explains Hillary Clinton’s ‘smart power'”. CNN. October 28, 2011.Wikipedia article: Hillary Clinton

#3366ff
Match citeit-numbers-written-out The match is not found because Quoted text writes number out as text rather than numbers

Wikipedia:

to a willingness “to remold society by redefining what it means to be a human being in the twentieth century, moving into a new millennium Source: “Let us be willing,” she urged in conclusion, “to remold society by redefining what it means to be a human being in the 20th century, moving into a new millennium.”

#3366ff
Match citeit-text-from-source Quote text needed to be replaced from the source

Replaced Quote

“can’t .. miss” Wikipedia: (Outdated): “can’t miss”

Source:

“can’t afford to miss”

#3366ff
Match, Feature citeit-later-match A later match (2nd or 3rd) would be preferable

Example:

“genocidal taunts”

Source: Quote found in the title, but better context is found in 2nd match in the article body.

#cc6600
Match, Feature citeit-feature-added-word A word is added to the quote using brackets:

Example:

[although] “we did not find clear evidence that Secretary Clinton or her colleagues intended to violate laws “

#cc6600
Match citeit-formatting-mismatch Looks like it matches, but doesn’t because of a formatting mismatch.

Example

“contends that they are not shapes of constellations but of what might be called <i>counter constellations</i>, the irregular-shaped dark patches within the twinkling expanse of the <a href=”https://en.wikipedia.org/wiki/Milky_Waytitle=”Milky Way“>Milky Way</a>”

#ff99ff
Match citeit-change-case Matches except for changing from upper to lower case or vice versa

Example

[T]he mudslides and heavy rains did not appear to have caused any significant damage to the Nazca Lines

#ff99ff
Match citeit-hyphen-change Matches except for changing hyphenization Nazca Lines  (TODO: find an example) #ff99ff
Match citeit-punctuation-change Matches except for punctuation changes: Example: quoted text ends in a comma, but Wikipedia quote uses a period

Live Example:

“Her articles were important, not because they were radically new but because they helped formulate something that had been inchoate.”[63]

Source:

Her articles were important, not because they were radically new but because they helped formulate something that had been inchoate, Professor Fox said

#ff99ff
Match citeit-omit-text-from-source The original source includes text that is not in the citing quote

Quote:

“Let me repeat what I have repeated for many months now, I never received nor sent any material that was marked classified.”

Original:

“Let me just repeat what I have repeated for many months now,” she said in the interview on “Meet the Press.” “I never received nor sent any material that was marked classified”

#ff99ff
Match, Feature citeit-feature-ellipses The quote is interrupted by ellipses and then later continued

Quote:

“There has never been a better time in history to be born a woman … this data shows just how far we still have to go.”

#ff99ff
Match citeit-non-quote Although Quotation Marks are Used, the Quote is a Title or Term, not a quote.

 Examples:

filegate“, “Hillary Doctrine

 

TODO: remove CiteIt link from quote so normal link is visible

#996600
Offline citeit-offline-no-isbn A publication that is not available Online without an ISBN

Example:

“<q cite=”” class=”citeit-non-quote citeit-offline-no-isbn”>Children’s Rights: A Legal Perspective</q>” in 1979

#3366ff
Offline citeit-offline-isbn A Book that is not available Online but it has an ISBN

Example:

“<q cite=”https://en.wikipedia.org/wiki/Special:BookSources/978-0-8050-9511-1″ class=”citeit-offline-isbn”>pivot to Asia</q>”

#3366ff
Private citeit-paywall The document requires a subscription

Example:

“<q cite=”https://www.jstor.org/stable/795794″ class=”citeit-paywall citeit-non-quote citeit-later-match”>Children’s Policies: Abandonment and Neglect</q>”

#666699
Google Books ** google-books Google Books Nazca Lines #6600cc
Private citeit-edu An academic document requires a subscription

Example:

“<q cite”https://meridian.allenpress.com/her/article-abstract/43/4/487/30983/Children-Under-the-Law” class=”citeit-paywall citeit-edu”>Children Under the Law</q>”

#6600cc
Twitter citeit-twitter Twitter generates its HTML using javascript, which I hope a future version of CiteIt can handle

Example:

<q cite=”https://thegolfnewsnet.com/golfnewsnetteam/2018/07/14/donald-trump-exercise-golf-cart-turnberry-110166/” class=”citeit-twitter”>primary form of exercise</q>

#3366ff
Archive.org Borrow citeit-archive-org-borrow The source is available to borrow electronically through Archive.org

Example:

<q cite=”https://archive.org/details/herwayhopesambit00gert” class=”citeit-archive-org-borrow citeit-later-match”>Hillarycare</q>

#6699ff
Wayback Machine citeit-archive-org Wayback Machine and other Archive.org that doesn’t require checking out

Example:

<q cite=”https://archive.org/details/herwayhopesambit00gert” class=”citeit-archive-org-borrow citeit-later-match”>Hillarycare</q>

#33ccff
Results citeit-no-context A Match is found, but no Context is Returned

Example:

“<q cite=”https://time.com/5309425/donald-trump-kim-jong-un-summit-document-full-text/” class=”citeit-no-context”>I’m not going to rule out a military option</q>

#ff6600
Match citeit-no-match The Quote was not found in the Cited Source

Example:

<q cite=”http://content.time.com/time/magazine/article/0,9171,2097973,00.html” class=”citeit-no-context”>convening power</q>

#cc0000
Editing citeit-better-link An Alternative Source is used Instead because it provides Better Context. Requires creating a new Footnote

Example:

<q cite=”https://www.washingtonpost.com/news/the-fix/wp/2016/07/28/here-is-hillary-clintons-presidential-nomination-acceptance-speech/” class=”citeit-better-link”>words from our Methodist faith</q>

green
Best-Practices citeit-naked-quote

The Citation is a Quote of a Quote, without the original Context

When CiteIt pulls in the context, the context is from the secondary source rather than the quoted source

If Wikipedia quotes an article in the New York Times, and the New York Times quotes the President.

How much of CiteIt’s 500 characters of context is from the New York Times and how much is from the President?

A naked quote would not have any context from the primary source (The President).  All of the context  CiteIt finds would be from the secondary source.

 

The post Wikipedia Citation Examples and Error Classes appeared first on CiteIt.net.

]]>
https://www.citeit.net/2020/10/18/wikipedia-citation-examples-and-error-classes/feed/ 0
Wikipedia’s Contextual Popups https://www.citeit.net/2020/10/14/wikipedias-contextual-popups/ https://www.citeit.net/2020/10/14/wikipedias-contextual-popups/#respond Thu, 15 Oct 2020 01:51:35 +0000 https://www.citeit.net/?p=2190 Wikimedia already has contextual popups which appear when a reader mouses over a linked article. Here’s a screenshot of the popup that appears on the Los Angeles Lakers article when a reader mouses over the link to the Los Angeles Sparks Basketball team.   View live article: Los Angeles Lakers   Screenshot: Adding Contextual Popups […]

The post Wikipedia’s Contextual Popups appeared first on CiteIt.net.

]]>

Wikimedia already has contextual popups which appear when a reader mouses over a linked article.

Here’s a screenshot of the popup that appears on the Los Angeles Lakers article when a reader mouses over the link to the Los Angeles Sparks Basketball team.

 

View live article: Los Angeles Lakers

 

Screenshot:

Los Angeles Lakers “Popup”


Adding Contextual Popups for Quotations

CiteIt’s Contextual Citations could add a similar popup for quotations, although I’m not necessarily proposing that the popup appear automatically on mouseover.

Here’s an example of a quote from the Ruth Bader Ginsburg article that is taken from the New York Times. CiteIt adds a Contextual Popup that displays the context from that cited New York Times article:

Ruth Bader Ginsburg article

Contextual Popup: New York Times article citation

View Ruth Bader Ginsburg example

 

Automating the Creation of Contextual Citations

Citeit provides a syntax for marking up the quotations’ links and a web service to automate the process of looking up the context and displaying it to the user.

You can view more about CiteIt for Wikipedia on in the new”Wikipedia” section of the site.

The post Wikipedia’s Contextual Popups appeared first on CiteIt.net.

]]>
https://www.citeit.net/2020/10/14/wikipedias-contextual-popups/feed/ 0
An Amazing Connection https://www.citeit.net/2020/09/22/an-amazing-connection/ https://www.citeit.net/2020/09/22/an-amazing-connection/#respond Wed, 23 Sep 2020 01:34:51 +0000 https://www.citeit.net/?p=2052 This weekend I got an email response from Mark Hershberger which is part of the amazing story about how I got a connection to Wikipedia. Walking in Akron I often go for walks around Akron (my hometown, pop. 4,000); and when I do I often stop to talk to people in their front yard. Last […]

The post An Amazing Connection appeared first on CiteIt.net.

]]>

This weekend I got an email response from Mark Hershberger which is part of the amazing story about how I got a connection to Wikipedia.

Walking in Akron

I often go for walks around Akron (my hometown, pop. 4,000); and when I do I often stop to talk to people in their front yard. Last summer, one of the people I happened to talk with yielded a rather amazing connection to Wikipedia!

I was talking to Alexis about her old Victorian House, which she maintains with purchases from the PaulB Zimmerman’s hardware store 1 and listened to how she had moved to Lancaster County from New Orleans.

Demoing CiteIt

I used my phone to demo my CiteIt.net App for her and her response was to make the same sort of connections I have. She said:

This would be great for journalists and Wikipedia.

I said:

Yes, I’d really like for journalists to use it, and if it succeeds beyond my wildest dreams, I’d like Wikipedia to use it.

Here’s the amazing part — she said next:

My husband works with Wikipedia! You should set up a meeting with him.

So I met with Mark, who works as a contractor packaging the Wikipedia software together into the MediaWiki distribution that anyone can install on their own server. We talked about getting some shared server hosting in the Wikipedia cloud, but it took me a while to get my web service running on Docker, which Mark is more comfortable with than the Python language the software is written in.

So I emailed Mark this month about the project with an actual proposal and he replied back that he is willing to help and he probably knows the right people to ask!

Case Study: 25 articles

The next step he identified for me is assembling a diverse list of articles that will allow us to understand all the ways that citations are used on Wikipedia.

So I started a list of about 25 articles in multiple languages that we can use as a starting point. I’ve annotated 5 of these articles already and I hope to get volunteer help annotating some of the rest.

The Long Road to Production-Quality Code

The other thing I realized is that it’s going to take a lot of work to make the CiteIt software rock-solid enough and user-friendly enough to run on Wikipedia in production, so I’m beginning the task of recruiting alpha testers to provide me with feedback.

I’ve created a list of about 25 journalists and academics I hope to contact, along with examples of their work that I can mark up as demos.


  1. PaulB is one of the businesses the company where I work owns

The post An Amazing Connection appeared first on CiteIt.net.

]]>
https://www.citeit.net/2020/09/22/an-amazing-connection/feed/ 0
CiteIt.net Wikipedia demo https://www.citeit.net/2020/09/06/citeit-net-wikipedia-demo/ Sun, 06 Sep 2020 14:27:35 +0000 https://www.citeit.net/?p=1976 Hello, this is Tim Langeman, creator of CiteIt.net a higher standard of citation for news organizations, academics, and web authors. This page contains a copy of the John F. Kennedy Inauguration Wikipedia article, along with the CiteIt.net javascript that this page uses to demonstrate the concept of contextual citations. The Problem: Often times when I’m […]

The post CiteIt.net Wikipedia demo appeared first on CiteIt.net.

]]>
YouTube Video

Hello, this is Tim Langeman, creator of CiteIt.net

  • a higher standard of citation
  • for news organizations, academics, and web authors.

This page contains a copy of the John F. Kennedy Inauguration Wikipedia article, along with the CiteIt.net javascript that this page uses to demonstrate the concept of contextual citations.

The Problem:

Often times when I’m reading a quotation, I think to myself:

That’s a nice-sounding quote, but I wonder what it said 2 sentences prior or 2 sentences after the quote .

In other words — what’s the context of this quote and how do I know this quote isn’t being cherry-picked?

Example:

Let’s look at an example of a cherry-picked quotation by Thomas Jefferson which is etched into the wall of the Jefferson Memorial in Washington DC :

Nothing is more certainly written in the book of fate than that these people are to be free.

At first impression, this sounds like a great patriotic quote that the country’s leadership could rightly etch onto the marble wall of a national monument to proclaim the righteousness of its conception.

Jefferson Memorial
Cherry-Picked Quote on the Jefferson Memorial

But if you click on the blue arrow below the quote, you will see the quote expand, displaying the 500 characters that follow.

It reads:

Nor is it less certain that the two races, equally free, cannot live in the same government. Nature, habit, opinion has drawn indelible lines of distinction between them. It is still in our power to direct the process of emancipation and deportation peaceably and in such slow degree as that the evil will wear off insensibly, and their place be pari passu filled up by free white laborers.

Upon further research, one can learn that this panel from the Jefferson Memorial is a compilation of excerpts rather than a single quotation.

But it is not just cherry-picked quotations that benefit from greater context. Many times a quote will take on greater meaning when the full context is understood.

Harvard Professor Laurel Thatcher Ulrich‘s comment that Well-behaved women seldom make history makes more sense if the reader has an easy way to inspect the context from her 1976 article from American Quarterly. (click the blue-grey link)

 

Two types of Contextual Citations:

I’ve just demonstrated the two types of contextual citations

  1. Blockquote with expanding arrows
  2. Inline Popup (blue-grey-styled link)

 

Bring Contextual Citations to Wikipedia:

So back to our Wikipedia page on the Inauguration of JFK ..

If you scroll down to the very bottom of this page, you will see an extended quotation with blue arrows above and below. Click on one of the arrows to expand the quotation.

This is the only expanding blockquote in the example, but there are numerous blue-grey contextual popups.

Goal: Ubiquity

I’ve developed the CiteIt.net app with the hope that contextual citation can become ubiquitous and  raise the social norms and quality of media.

Open Source: MIT License

I have chosen to use the MIT license to open-source my code for the both CiteIt.net’s javascript client and the python api server.

While I realize that open-sourcing my code may be less lucrative, it is my hope that using a nonrestrictive license like the MIT-license will allow contextual citation to gain greater adoption and attract more collaborators than a proprietary license would.

If you’d like to help me in my quest to make contextual citations an expectation of all serious media, check out the links below to contact me with suggestions or volunteer.

And just like Wikipedia has developed a standard notation that says: “citation needed“, I’ve tentatively developed a playful little jingle

So, whenever someone makes a claim without any evidence (cwae) , you can playfully sing the CiteIt.net jingle to them:

Can you CiteIt?  Can you CiteIt?

Next Steps

You can learn more about technical details behind the CiteIt.net contextual quotation system by:

  1. Reading more about this Video
  2. Downloading the Sample Code and Viewing the Developer Video
  3. Test-Driving the WordPress plugin on the Demo Site
  4. Reading the Proposal for incorporating Contextual Citations into Wikipedia

 

How it works:

So how does the citation system work?

1. Markup the URL:

The first step a Wikipedia author needs to do is mark up their quote by adding the source’s URL using the blockquote “cite” attribute, like this:

<blockquote cite="https://www.vanityfair.com/news/2011/02/kennedy-201102?currentPage=all">
    O'Neill recalled that Kara had nudged him and said ..
</blockquote>

2. Publish the Article, with citation markup

  • If using the CiteIt.net WordPress Plugin, the plugin will automatically take care of steps 3 and 4
  • MediaWiki could be similarly modified to notify the CiteIte.net api that a new contextual JSON file should be generated for each citation whenever an article is published or updated.

3. Get the Article’s URL

Example:

 https://en.wikipedia.org/wiki/Inauguration_of_John_F._Kennedy

4. Notify the API service that a new citation was published:

When the author publishes their article, the software they use — in this case MediaWiki — contacts the CiteIt.net web service with the URL of the article they just cited. (HTTP POST preferred)

https://api.citeit.net/?url=https://en.wikipedia.org/wiki/Inauguration_of_John_F._Kennedy

5. API Retrieves newly published article:

The web service retrieves the author’s article and looks for all the quotes within the article that have a “cite” attribute containing a URL

Quotes on the demo JFK article with a Cite attribute:

 

Web service looks up quote sources:

The web service then looks up the source URL of each citation and validates the quote’s accuracy

Validate Quote:

If the quote is accurate, it extracts the 500 characters of context surrounding the quote and saves it to a JSON file stored in the Cloud.

JSON file: example: read.citeit.net
JSON file is stored on read.citeit.net

Display the Context to the Reader:

When the Wikipedia reader visits the author’s article, javascript on the (Wikipedia) website directs the reader to load the JSON file that the web service created and displays the surrounding quote context when the reader clicks on an arrow or popup link.

Click on Grey-Blue links to get Contextual Popup

 

More Information:

You can view more information on my website: www.CiteIt.net and if you want to test-drive the app, you can used the WordPress CiteIt.net plugin to easily create quotations on the demo.CiteIt.net website.

You can try out the CiteIt.net WordPress Plugin on the Demo Site.

The Code for both the client and webservice is open source and available under the MIT-license at www.CiteIt.net/code
Code screenshot

Alpha Code:

The code for this project is alpha-status so don’t be surprised if you find bugs or a lack of polish.

Improving: Building Production-Ready?

I’m interested in exploring whether Wikipedia would have an interest in using my contextual citations idea, in the event that it could be improved and become production-ready.

Volunteer:

Check out the volunteer page if you are interested in helping with the testing or programming; and feel free to drop me an email if you have suggestions.

The post CiteIt.net Wikipedia demo appeared first on CiteIt.net.

]]>
Dr. Lee Giles: Contextual Citations https://www.citeit.net/2020/08/21/dr-lee-giles-contextual-citations/ Fri, 21 Aug 2020 22:43:41 +0000 https://www.citeit.net/?p=1956   Hello Dr. Giles, I’ve developed an app for creating contextual citations for the web and, given your work with CiteSeer, I’m interested in gauging whether there would be interest within academia for my project. What are Contextual Citations? Contextual citations, as I’ve implemented them, allow authors to demonstrate the context of their citations by […]

The post Dr. Lee Giles: Contextual Citations appeared first on CiteIt.net.

]]>

 

Hello Dr. Giles,

I’ve developed an app for creating contextual citations for the web and, given your work with CiteSeer, I’m interested in gauging whether there would be interest within academia for my project.

What are Contextual Citations?

Contextual citations, as I’ve implemented them, allow authors to demonstrate the context of their citations by expanding the 500 characters of the context surrounding a quote. (See Demo below)

Writers can create contextual citations by marking up their citations using a “cite” attribute and calling a web service that looks up their citation and extracts the surrounding context into a JSON file.

<blockquote cite=“http://avalon.law.yale.edu/19th_century/jeffauto.asp”>

Nothing is more certainly written in the book of fate than that these people are to be free.

</blockquote>

Reader’s browsers then retrieve the surrounding JSON data and display it when the user clicks on the blue arrows above and below a quote, or for shorter inline quotes, clicking on a styled link to view a popup.

 

Demo: Two examples of contextual citations:

1. Blockquote: longer quotes

Jefferson Memorial
Cherry-Picked Quote on the
Jefferson Memorial

The Jefferson Memorial quotes Thomas Jefferson’s autobiography:

Nothing is more certainly written in the book of fate than that these people are to be free.

But if you click the blue down arrow and read the next few lines, you can quickly see that Jefferson’s original meaning was distorted by the removal of the quote’s context.

2. Inline quotation: shorter quotes

But catching cherry-picked citations isn’t the only advantage of being able to preview the surrounding context. Often the context provides the reader with a fuller understanding of the meaning. Take the following quote about “Well-behaved Women ..”.

Harvard Professor Laurel Thatcher Ulrich‘s recently popularized quip that “Well-behaved women seldom make history” appears on T-shirts, but do you know the original context? (click the above link)

Additional Examples:

To personalize things, I decided to cite one of your publications on the subject of RefSeer:

RefSeer:

Here’s is an example of a citation describing RefSeer:

a citation recommendation system which automatically suggests can-didate citations based on input queries. RefSeer has appli-cations for both researchers and reviewers. While authoring a paper, researchers can use our citation recommendation system to find prior works related to the problem they seek to investigate. In turn, reviewers can use RefSeer to check whether a paper cites all relevant papers

When I published this blog post, it looked up the PDF for your publication and extracted the 500 characters of surrounding text into a JSON file that my web service saved to a CDN.

I have also created a WordPress demo that you can use to test-drive what a web application that implements contextual citation is like in real practice.

The CiteIt.net web app uses a web service that is written in Python and is packaged with Docker. The Docker version supports text and Html but not PDF.

Open Source logo
Open Source: MIT License

The native Python version, which is available from GitHub does support PDF. All code is open-source, licensed under the MIT License.

(more: Test-drive WordPress Demo with video)

How Contextual Citations Work:

  • When an author publish a citation (in Html), they add a “cite” attribute to their citation tag: <blockquote cite=”cited-url”>quote</blockquote>
  • The author or CMS system makes a call to the api.citeit.net web service when the publication takes place.
  • The web service receives the URL of the citing publication and retrieves a copy, looking for any blockquote or q tags that contain a cite attribute with a valid URL.
  • The web service retrieves each cited document and validates whether the quote matches the source.
  • If the quote matches, it extracts the 500 characters of the surrounding context and saves it to a JSON file, which is then saved to a CDN or public webserver.
  • The reader’s browser uses javascript to look up this JSON file when browsing the citing document.
  • If the reader clicks on the arrows or text link, the javascript renders the JSON file that it got from the web service and displays it to the user in a div above the quote or in a popup.

(more: Developer Information with video)

Questions for Dr. Giles:

 

  • Do you think a free open-source contextual citation system would be useful to academics?
  • Many academic papers are published in PDF. Do you think a contextual citation system needs to be able to display an expanding/popup user interface from within PDF to be useful, or would the ability to cite PDFs from within Html be enough?
  • How significant of a barrier do you think access restrictions are to the implementation of contextual citations in academia?
  • Do you have any colleagues who might be interested in learning more about CiteIt.net’s Contextual Citation?

 

 

Citing YouTube transcripts:

Although I haven’t heard of academic publications citing video transcripts, I have also been working on citation of audio and video. 

As an example, consider the following quote from James Burke‘s “Connections” series about a “crafty way” the Library of Alexandria assembled their collection:

Now, they got these scrolls, either because the local scholars wrote them or because they had a rather crafty law. See, if you came to Alexandria on a boat and you owned a book you had to lend it to the library to be copied. And sometimes the copies were so good the owners went off with the fakes and the library kept the original.

About me:

I was born in Winnipeg Manitoba but grew up in Lancaster County, Pennsylvania.  I majored in history at the University of Waterloo in Ontario, Canada.  I took some electives in computer science while I was there.  After I graduated in 2001, I got a job as a computer programmer and I’ve worked as a programmer ever since. 

The CiteIt.net app arose out of an interest in writing a review of hypertext pioneer Ted Nelson that was more in the spirit for his original vision for hypertext.  I’ve been working on this Citation project since 2015 as a hobby.

Long-term Goals:

If everything works according to plan, I’d like to work on this full-time for an organization like the Internet Archive under a grant from an organization like the Knight Foundation.  I’d like CiteIt.net to expand to include text, audio, and video and my goal is to maximize the good that I create and inspire rather than the amount of money that I capture.

If you have any suggestions for how I should proceed, sent me an email.

The post Dr. Lee Giles: Contextual Citations appeared first on CiteIt.net.

]]>
We’re no longer in the Walter Cronkite Days https://www.citeit.net/2020/08/20/carol-leonnig-were-no-longer-in-the-walter-cronkite-days/ Thu, 20 Aug 2020 22:41:06 +0000 https://www.citeit.net/?p=1947 Hello Carol, For the past 5-years, I’ve been working on an app to help serious writers, as you say, show you how we made the cake. So when I heard you said during your A Very Stable Genius book tour that we’re no longer in the Walter Cronkite days and that journalists need to practice […]

The post We’re no longer in the Walter Cronkite Days appeared first on CiteIt.net.

]]>

Hello Carol,

For the past 5-years, I’ve been working on an app to help serious writers, as you say, show you how we made the cake. So when I heard you said during your A Very Stable Genius book tour that we’re no longer in the Walter Cronkite days and that journalists need to practice greater transparency, to demonstrate how they did their reporting, I made a mental note that you might be a good person to ask to beta-test my app once it was ready for testing.

What I want from you:

I’d like your feedback (to 4 questions) about my app so that I can determine its potential value for journalists.

1) The Problem I’m Trying to Solve:

CherriesOften when I read a quotation, I think to myself, “that’s a nice quote, but I wonder what it says two sentences prior, or two sentences after the quote.  In other words, what’s that context, and how do I know that this quote wasn’t cherry-picked?

Out-of-context (or Cherry-picked) quotations are an age-old problem, but one which new digital tools are uniquely able to combat.

YouTube Video

There is a Cherry-Picked Quote on the Jefferson Memorial.

Take for example the following quotation from Thomas Jefferson’s 1821 Autobiography, which is etched into the wall of the Jefferson Memorial in Washington DC:

Nothing is more certainly written in the book of fate than that these people are to be free.

Cherry-Picked: Out-of Context Quotation on the Jefferson Memorial

Cherry-Picked Quote on the Jefferson Memorial

In this case, if you click on the blue down arrow, you can see from the subsequent 500 characters of context that Jefferson talks about a process of “emancipation and deportation“, a detail that is missing from the compilation of excerpts etched into the Jefferson Memorial.

 

Demonstrate your Credibility: Show Your Sources:

As the Jefferson Memorial shows, cherry-picked quotations aren’t a new problem, but today’s authors face a growing climate of distrust and accusations of “Fake News“. The level of suspicion has gotten so bad that many Americans refuse to believe even direct quotations from mainstream publications.

I’ve created CiteIt.net to develop tools to allow credible authors to better inform their readers and differentiate themselves from the unserious and malicious and with the goal of creating a higher standard for citation authorship.

2) Examples: “How we Made the Cake”

I took a quote from your book tour presentation and turned it into the following example of contextual citations.  It can be expanded: (click blue arrows)

We’re no longer in Walter Cronkite days. The consequence is people don’t agree on facts. And Phil and I have an extra job in addition to bringing you facts and that extra job is something the Post also takes really seriously with is now we got to show you how we made the cake. We’ve got to show you how we did the reporting or else you’re not going to believe us. And that’s our new chore.

Other Examples:

I’ve listed a few other examples of how contextual citations like this can be displayed:

A. Laurel Thatcher Ulrich: (inline popup)

Harvard Professor Laurel Thatcher Ulrich‘s recently popularized quip that “Well-behaved women seldom make history” appears on T-shirts, but do you know it’s original context?.

B. Rabbi David Wolpe:

I think that Judaism has the same problem that any thick civilization has in a world in which, as you say, context is stripped away. And not only is context stripped away, but attention to any one thing is scanter and less than it used to be. So, for example, a lot of Jewish commentary is based on your recognizing the reference that I make. Who recognizes references anymore? Because people don’t spend years studying books.

3) A Tool to make Contextual Citations easy:

I’ve developed a free plugin for WordPress and a Web Service that makes it easy to create contextual citations.  You can try it out on the demo page.

YouTube Video

 

I expect larger institutions like the Washington Post would like to download and customize my code to work with their particular software.  That should be fairly easy, because my code is open source and freely available.

4) What’s In it for Me?

My long-term goal is to work on CiteIt.net full-time for a nonprofit with an aligned mission, like the Internet Archive.  (See Long-term Goals)

5) Feedback Request: Questions for Carol:

  1. Do you think the type of contextual citations created by my App would be valued by some portion of the journalism profession?  If only a subset, who do you see as the early adopters, and who would be the laggards?
  2. What do you think the most difficult challenges would be to overcome?
  3. Do you see a contextual citations being more relevant to some stories than others: breaking news, investigative stories, opinion columns, etc?
  4. Would you like to hear more about this project in the future?

About me: Tim Langeman

I was born in Winnipeg Manitoba but grew up in Lancaster County, Pennsylvania.  I majored in history at the University of Waterloo in Ontario, Canada.  I took some electives in computer science while I was there.  After I graduated in 2001, I’ve worked as a computer programmer ever since. 

The CiteIt.net app arose out of an interest in writing a review of hypertext pioneer Ted Nelson that was more in the spirit for his original vision for hypertext.  I’ve been working on this Citation project since 2015 as a hobby.

 

Long-term Goals:

If everything works according to plan, I’d like to work on this full-time for an organization like the Internet Archive under a grant from an organization like the Knight Foundation.  I’d like CiteIt.net to expand to include text, audio, and video and my goal is to maximize the good that I create rather than the amount of money that I capture.

If you have any suggestions for how I should proceed, sent me an email.

Open Source

I intend to pursue CiteIt.net using a nonprofit model, making the code available as open source.  I would allow others to develop commercialized applications, just as Tim Berners-Lee has allowed the web to be commercialized.

The post We’re no longer in the Walter Cronkite Days appeared first on CiteIt.net.

]]>
Source Metadata https://www.citeit.net/2020/08/19/source-metadata/ Thu, 20 Aug 2020 03:06:22 +0000 https://www.citeit.net/?p=1903 Voluntary Citation Disclosure Providing authors with more advanced and granular means of citation promotes better writing and increases readers’ understand and trust. Here are a few questions that could be voluntarily answered by authors: Do you have a source for that? Yes, Can you name the source? Author/Organization, Title, Publisher/Site, Date What kind of source […]

The post Source Metadata appeared first on CiteIt.net.

]]>

Voluntary Citation Disclosure

Providing authors with more advanced and granular means of citation promotes better writing and increases readers’ understand and trust.

Here are a few questions that could be voluntarily answered by authors:

Do you have a source for that?

Yes,

Can you name the source?

Author/Organization, Title, Publisher/Site, Date

What kind of source is it? (Primary/Secondary)

1. This is a first-hand account.

Rate its Authenticity:

  • I have access to the original physical source.
  • I have access to the original electronic source.
  • I have access to a scan of the original (image)
  • I have a transcription of the source
  • The source is a translation.

Rate its Originality:

  • This the first publication.
  • This is a republication of the original

2. This is commentary that relies on first-hand (and possibly secondhand) accounts.

  • The source is named.
  • The source’s affiliation is disclosed: an anonymous administrative official.
  • Nothing is know about the source: a truly anonymous source.

3. This is commentary that does not have primary sources.

Google is Built on Citations. How can we build on and advance these citations?

Google motivates people to improve their websites to the point that many organizations hire search engine optimization teams to develop content that will raise the organization’s google rankings.

But what if people on the internet voluntarily developed standards to hold themselves to higher standards of evidence and civility, extending the concept of page rank to include portions of a page and more descriptive sources being cited?

The post Source Metadata appeared first on CiteIt.net.

]]>
How to Use the Demo CiteIt.net Site https://www.citeit.net/2020/08/10/how-to-use-the-demo-citeit-net-site/ Mon, 10 Aug 2020 18:50:07 +0000 https://www.citeit.net/?p=1888 Transcript Hello this is Tim Langeman, creator of CiteIt.net: a higher standard of citation for news organizations, academics, and web authors. Wouldn’t it be great if web authors could easily demonstrate the authenticity and context of their quotations to skeptical and curious readers? 2 Types of Citations CiteIt.net enables authors to do just that through […]

The post How to Use the Demo CiteIt.net Site appeared first on CiteIt.net.

]]>

YouTube Video

Transcript

Hello this is Tim Langeman, creator of CiteIt.net:

a higher standard of citation
for news organizations, academics, and web authors.

Wouldn’t it be great if web authors could easily demonstrate the authenticity and context of their quotations to skeptical and curious readers?

2 Types of Citations

CiteIt.net enables authors to do just that through the choice of two different citation options depending upon a citation’s length.

1) The first type of citation is the expanding block quote which is used for longer quotes that form their own paragraphs.

2) The second type of citation is for shorter quotations and uses a popup window to display the context without disturbing the original paragraph.

We don’t need to have a WordPress website or install the plugin to do a test-drive. Simply go to the demo area and login with the supplied password.

Let’s begin by clicking Posts > Add New to create a new Post.

We are now ready to create each of the 2 types of citations:

  1. the blockquote, and
  2. the inline popup.

Blockquote Citations

We can enter the title and intro for our post like we ordinarily would compose a post.

In the next step, we grab a copy of our quote, which in this case is on the medium.com website.

We select our text and then right-click and select copy.

Next, we switch back to the editor tab and paste the quote in the position where we want it.

Making sure to first select the quote, we next click on the CiteIt.net blockquote button. This is one of two buttons that the CiteIt.net WordPress plugin adds to the editor.

When we click on the CiteIt.net blockquote button, a window pops up for us to enter our source’s URL.

To enter the URL, we switch to the tab containing the Medium.com article and copy the URL from the address bar using “right-click Copy”.

We then switch back to the blog post and paste the URL into the popup window and click “OK“.

The blockquote paragraph should now be indented and we are ready to click on the “Publish button“.

For webpages, the app should only require a few seconds to request the article and find the 500 characters of context before and after the original source. PDF and YouTube pages take longer unless they’ve been previously downloaded and cached.

We’re now ready to view the published post by locating the post’s permalink and clicking on it.

We should now see the published post, with the blue arrows above and below the quote.

If we click on the arrows, we should see the surrounding context appear and disappear as we toggle the arrows.

If we want to visit the original source, we can click on the “source” link.

Inline Popups

Ok, we’ve done with the first of the two citation formats. Now its time to do the second type of citation — the “inline popup“.

We can make a new post for the inline popup example and enter some text for a title and body. The source for this post is a Wikisource publication of Jane Austen’s Pride and Prejudice.

So I’ll grab one of the lines that helps explain the book’s title:

“I could easily forgive his pride, if he had not mortified mine.”

The process that we use next is exactly the same as for the blockquote, but this time we will click on the “inline popup button“.

After we’ve copied the quote into the blog post, we make sure it is selected and we click the second CiteIt.net button — the inline popup.

We locate the page’s URL and copy it into the popup prompt.

This time, the quotation is not automatically indented. Rather, the inline popup can appear in the middle of a paragraph without breaking up the text.

When we click “Publish” the App contacts Wikisource for the original quote and locates the 500 characters before and after the quote. It then saves the context in a little text snippet which the readers load when they click on the arrows or popup link.

Let’s now click on the “permalink” button again to view the published post.

This time, instead of expanding arrows, we see double-blue lines under our quote.
If we click on the link, a popup appears, showing the original quote, along with the surrounding context.

Summary:

Thank you for your interest in CiteIt.net
a higher standard of citation
for news organizations, academics, and web authors.

In this video I’ve demonstrated how to use the CiteIt.net WordPress plugin to make two types of citations:

  1. Using the blockquote tag for longer quotations
  2. Using the inline popup for shorter selections

 

CiteIt.net aims to change norms,
so next time you read or hear someone make an unsubstantiated quotation or claim, ask them:

Can you CiteIt? Can you CiteIt?

The post How to Use the Demo CiteIt.net Site appeared first on CiteIt.net.

]]>
How to Install and Use the CiteIt.net WordPress Plugin https://www.citeit.net/2020/08/08/how-to-install-and-use-the-citeit-net-wordpress-plugin/ Sat, 08 Aug 2020 23:43:04 +0000 https://www.citeit.net/?p=1785 Video Transcript Hello, this is Tim Langeman, creator of CiteIt.neta higher standard of citationfor news organizations, academics, and web authors. Today’s video will demonstrate how to: install the CiteIt.net WordPress Plugin and how to use the plugin to cite a sample article on medium.com About this Version: This plugin is designed for the older WordPress […]

The post How to Install and Use the CiteIt.net WordPress Plugin appeared first on CiteIt.net.

]]>
YouTube Video

Video Transcript

Hello, this is Tim Langeman, creator of CiteIt.net
a higher standard of citation
for news organizations, academics, and web authors.

Today’s video will demonstrate how to:

About this Version:

This plugin is designed for the older WordPress version 4 editor.

If you would like to help me program a WordPress Gutenberg plugin, check out the GitHub ticket and send me an email.

1) How to Install the CiteIt.net WordPress Plugin

Let’s start by going to the CiteIt.net homepage and clicking on the “WordPress Plugin” link in the top navigation bar.

This will take us to the plugin page where we can scroll down and click on the blue “Download WordPress Plugin” button.

Download WordPress Plugin
(For your convience, I’m not going to make you go back to the WordPress plugin page to download the plugin. Instead, you can click the button below)


We should now have a CiteIt.net.zip file saved to our local Downloads folder. Let’s remember where this file is while we log in to our WordPress site and click “Plugins“.1

View Downloads Folder: See "CiteIt.net.zip" file
This file will be saved wherever your browser downloads normally are saved to.

The next thing we want to do after we’ve clicked “Plugins” is click the “Add New” button to add the new plugin.

"Add New" Plugin
Click “Plugins” > “Add New

When we do this, we should see an “Upload Plugin” button.

Upload Plugin
Click “Plugins” > “Add New” > “Upload Plugin

(This plugin is not in the WordPress store yet because it is still in alpha testing mode while I work out the bugs.)

We next click on the “Upload Plugin” option which produces a screen that allows us to upload the plugin’s zip file by selecting the “Choose file” button.2

(TODO: get a Windows screenshot)

Now that we have the plugin’s zip file selected, we should see the CiteIt.net.zip filename appear next to the “Choose File” button:

Choose File: CiteIt.net.zip
(When you click on “Choose File” you will see a popup window prompt you to locate the “CiteIt.net.zip” file you previously downloaded.)

After you’ve selected your file, the next step is to select: “Install Now“:

Install Now

We should next see a screen offering us the chance to “Activate Plugin“, which we now click.

Activate Plugin
Plugin” > “Add New” > “Activate Plugin

The plugin is now installed.
You should see the Plugin listed alongside your other plugins.


One thing to note is that the plugin version number is displayed in the bottom left of the Description.

This version number can be useful in telling you whether you are running the latest version.

View Plugins: CiteIt.net

If you decide that you no longer want to use the plugin, just click “Deactivate“.

  • This will give you the option to delete all the files in the CiteIt.net folder and then delete the folder.

 

FYI: If you are wondering where the plugin is stored, here’s the directory structure of my Linux server:

View FTP folders

2) How to Cite a quotation using the CiteIt.net WordPress Plugin:


Ok, so assuming that you’ve got the Citeit.net WordPress Plugin already installed, here is how you can use the plugin to create expanding citations.

a) First, go to the “Posts” section and click “Add New“.

Posts: Add New
Posts” > “Add New

b) Next, give the post a title and begin typing your post body:

Insert Quote in Post Body
(After you’ve written the introduction to your post, you are now ready to insert the quote where it says “Insert Quote here“)

Copy Quote from Article

c) In this next step, you locate the quote you want to cite and copy it into your blog post.

In my case, I already know the quote I want is in a medium.com article which I have open in another tab.

I switch to the other tab and select the quote I want.

Select Quote: CiteIt.net Example
select the quote and copy it to the clipboard.

I then copy the text to my clipboard, which on my computer involves “Right Clicking” and selecting “Copy” from the menu. (shortcut: Ctrl-C)

Copy Selected Quote
After selecting the text: “Right click” > “Copy

d) I next switch back to the blog post tab and paste the quote contents by “Right Clicking” in the space under the previous paragraph and selecting “Paste“. (shortcut: Ctrl-V)

Paste Selected Quote
To Paste: “Right-click” > “Paste

I now have pasted the quote in my blog post and the next step is to turn this into a linked CiteIt.net expanding blockquote.

Pasted Quote Results
(The quote has been copied over to the blog and is ready to cite using the custom buttons)

It is now time to take advantage of the Two new CiteIt.net custom buttons that the CiteIt.net WordPress plugin has added to the editor.

View CiteIt.net WordPress Buttons
I’d like to make these buttons prettier, so if you have tips on making them better icons, send me an email.

e) I highlight my quote and click on the “CiteIt.net blockquote” button.

Click: CiteIt.net blockquote button
Highlight the quote and click the “CiteIt.net blockquote” button.

f) This pops up a window that prompts me for the source’s URL, which in my case is the medium.com article.

The URL can be copied from the browser address bar:

Copy Page URL
Copy the URL from the address bar

g) so I switch tabs back to the medium.com article and copy the URL from the address bar (right-click-copy).

and paste it into the custom popup window: (right-click paste)

Paste URL into CiteIt.net Blockquote Popup
(The popup will appear when you click on the “CiteIt.net blockquote” button)

h) Click “OK” to submit the URL; and you should notice that the quote is now indented:

For the Technically Inclined

The following technical info is useful for troubleshooting:

(You can skip it if you want.)

This next bit of the video is For the Technically included to troubleshoot the code if something goes wrong. Don’t fret if the following technical detail goes over your head.

If you’re technically inclined, you can inspect the Html code and you will notice that a <blockquote> Html tag has been wrapped around the quote.

WordPress Blockquote: Indented
After the “CiteIt.net blockquote” button is used, the quote will be indented.

If you switch the editor to code view (Text), you can see the new blockquote tag in the Html code:

WordPress Text Mode: Blockquote Code (CiteIt.net)
In the upper-right, select “Texttab to see the html code view.
Notice the “<blockquote cite=”https://medium.com/..”> tag

For our purposes, the most important part of the code is that the blockquote has a “cite” attribute in which the medium.com URL is populated.

(End Technical Troubleshooting segment)

 

Publishing the Post

i) We can now switch back to visual mode by clicking on the “Visual” tab and clicking “Publish

Wordpress Classic Editor: Visual Mode
The “CiteIt.net” buttons only work on the “Visual tab“.

j) After a brief wait, we can view the post by clicking on the “Permalink” or “View Post” link.

Clicking on the Permalink will take us to the published post.

Wordpress Permalink
If you click on the “permalink” you will go the public view of the post.

Viewing the Post

k) When we view the post, we should see the blue contextual arrows above and below the quote.

CiteIt.net Blockquote: Expanding Blue Arrows

When we click on the arrows, we should see that the text between the quote expands to show the grey hidden context of the 500 characters before and after the quote.

CiteIt.net Expanding Blockquote: Quote Context
(When you click on the blue arrow, the circled grey context appears.)

Summary

If you have followed along with this video, you have now successfully:

1) installed the CiteIt.net WordPress Plugin and
2) created your first expanding contextual quotation.

More Information

As you get more comfortable with contextual blockquotes, you can expand your knowledge by:

Thank you for your interest in CiteIt.net
a higher standard of citation
for
news organizations, academics, and web authors

CiteIt.net aims to change norms,
so next time you read or hear someone make an unsubstantiated quotation or claim, ask them:
Can you CiteIt? Can you CiteIt?

 


  1. If you don’t have a WordPress site of your own, you can test-drive the WordPress plugin which is already installed on the demo.citeit.net website.

  2. You can also drag and drop the file onto the “Choose file” button.

The post How to Install and Use the CiteIt.net WordPress Plugin appeared first on CiteIt.net.

]]>