Install WordPress plugin
The CiteIt Wordpress plugin is the
easiest way to start experimenting with CiteIt on your website. VIDEO Installation Download WordPress plugin (alpha)
How to Install the plugin
The WordPress plugin is
not yet part of the WordPress because it has not yet been widely Plugin directory tested.
I don't want to get a bunch of negative reviews for
bugs. After you've tried it out, send me an email with feeback.
Once I get enough positive feedback, I hope to add it to the plugin directory.
Gutenburg Volunteer Wanted
I’m looking for a volunteer to
. The CiteIt WordPress plugin currently uses the Classic Editor (TinyMCE). convert this plugin to Gutenberg Version History add labels to Blockquote Context add style formatting add background color to blockquote indent context: indent, add tooltip to label Edit Popup add “source” label & url change title add permalink to blockquote and q tags to display context on non-canonical pages (the home page, etc) add “Right and Left Quotation” to Unicode Escape characters change style: q-tag link: double underline, remove border from quote arrows update dependency: bump lodaash from 4.17.15 to 44.17.19 in /lib/link-to-text-fragment format q-tag links and popup window add error hardlinking to YouTube embed: url_parsed.params.start add Logic to Expand: YouTube Vimeo, and Soundcloud fix Quote-Context Arrows: remove border change version to 3-part number convert UTF-16 to UTF-8 June 22, 2020: (download 0.4.2) change webservice submission url: http://api.citeit.net/v0.4/url/ add forge-sha256 build update jQuery version to 3.4.1 update forge-sha256 update jsVideoURLParser preserve html in TinyMCE editor quote selection June 18, 2020: (download 0.4.x) ( 0.63) June 13, 2020: (download 0.4.x) ( 0.62) add function isWordpressPreview() to CiteIt-quote-context: – detect if current URL is in preview mode – remove querystring if in “preview” mode rename existing function names: use camel case Jan 29, 2020: (download 0.4.x) ( 0.61) switch toggle_quote to reference arrow anchor rather than parent div switch toggle_quote to reference arrow anchor rather than parent div CSS add <a class=‘quote_arrows’ to support styling change display to “block” to get rotate to work remove link outline from arrows add transform support for legacy browsers make contextual popup appear on top: z-index: 9999 rename neotext -> citeit Jan 25, 2020: (download 0.x.x) ( 0.60) quote-context.php: register style, remove text/css attrib from style sheets enqueue style sheet fix validation errors add toggleClass(“rotated180”); Jan 18, 2020: Escape Text using Unicode Codepoints switch endpoint to: http://api.citeit.net
that marks up citations and calls the web service. sample code
If you want to
use CiteIt.net with a CMS or other platform, this code should give you an idea of how to adapt your code. Get Sample Code on GitHub 2) Python API Webservice
This is the code for the
This program accepts a URL “POST” request
The program downloads the contents of the POSTED URL and looks for <blockquote cite="URL1"> and <q cite="URL2"> tags. It then downloads the contents of each URL and calculates the context immediately prior and after the quote It saves the results to a SQL-lite or PostgreSQL database (todo) It saves a JSON file to the local filesystem It (optionally) uploads the JSON file up to a Cloud Service 2 Ways to run the webservice: A) Python
The webservice is written in Python, using the
Flask framework. Get Python Code on GitHub B) Docker
If you don’t want to configure the Python code, you can run the Docker image instead:
Get Docker Hub Image Note: Amazon S3 Dependency
At this point the webservice
uploads the JSON files to . Amazon's S3 service
If you want to abstract away this dependency on Amazon, I'd be happy for a
contribution that provides alternatives.
(The python code involving Amazon S3 is part of the citation class's
json_upload method) Webservice Calls Volunteer CiteIt.net is an open-source project ( MIT license) whose mission to create a higher standard of citation is accelerated through the help of volunteers.
contact Tim to help out. View Trello board Top Tasks
Here are a few of the
I released the CiteIt client and server code under an
open source license because I want the concept of Contextual Citations to spread as widely as possible. According to Wikipedia: The MIT License is a permissive free software license originating at the Massachusetts Institute of Technology (MIT) in the late 1980s. As a permissive license, it puts only very limited restriction on reuse and has, therefore, high license compatibility. Commercial-Friendly:
Some people and companies are wary about using
open source software because . they do not like the GPL's requirement that they make their code revisions open source
I wanted to remove this objection to adopting CiteIt, so I chose an
open source license that does not require derivate works to be open-sourced. Use it as you like. Feel free to sell your derivative works without revealing your source code changes. Just don't sue me! :-) The MIT License Text
© Copyright 2021 Tim Langeman
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.