Giter VIP home page Giter VIP logo

conradish-x's Introduction

Conradish

Conradish is a Chrome extension that lets you create print version of online news articles. It strips out ads and other distractions, reformatting text to a uniform, professional look. In addition, it lets you attach footnotes to words and sentences.

The extension was designed with educators in mind, those who wish to make use web materials in the classroom. It is especially useful for teachers of foreign languages thanks to its automatic translation feature.

Conradish transformation

Features

  • Printing only selected portion of an article
  • Removal of ads and images
  • Simplification of page layout
  • Editing of text prior to printing
  • Point-and-click content scrubbing.
  • Addition of footnotes
  • Integration with Google Translate

User Guide

Creating print version of article

To create a print version of the article that you're viewing, first select the portion you wish to print. Don't worry if the selection ends up including undesired navigational elements—these will get filtered out. After making the selection, right-click on it (or press the menu key on your keyboard) and choose Create print version:

Context menu

You can trigger the same action in the extension's menu, if you elect to not add an extra item to the browser's context menu:

Pop-up menu

The print version will open up in a new browser tab:

Print version

Annotating article

Adding definition

Select the term for which the definition is desired. A pop-up menu will appear underneath. Choose Add definition:

Annotation menu

If the To language specified in the side-bar differs from the From language, Conradish will look up the definition at Google Translate and insert it automatically as a footnote:

Footnote

If the To language matches the From language or if "None" is selected, then you'll need to enter the definition yourself.

Footnote

You can undo the action by pressing Ctrl-Z on your keyboard.

Adding translation/explanation

Select the sentence you wish to be translated. A pop-up menu will appear underneath. Choose Add translation:

Annotation menu

The translated sentence will then appear in the page's footer:

Footnote

The Add translation functionality only differs from Add definition in that the original text is omitted in the footnote.

Both Add definition and Add translation will appear in the menu when more than one word (but less than 8) are selected.

Add explanation will appear in the menu instead when no translation would actually occur (the To language is the same as the From language or "None" is selected).

Choosing alternative translation

To choose an alternative translation, click on the definition part of a footnote and choose from the pop-up menu:

Footnote

Removing footnotes

To remove a footnote, simply delete the associated footnote number:

Footnote number

Or delete the footnote entry:

Footnote

Editing article

You can make changes to an article as you annotate it. The pop-up menu that appears whenever you select some text could be a distraction, however. To turn it off, choose "Editing" in the Action drop-down in the side-bar:

Action drop-down

Click the Finish button to return to annotation mode.

Applying text style

To apply text style to the document, choose "Styling" in the Action drop-down in the side-bar:

Action drop-down

If you wish to change the size of a heading, place the text cursor inside it, then click one of the buttons in the tool-bar that appears below:

Block style toolbar

If you wish to bold or underline a word, select the word, then click the applicable button in the tool-bar that appears underneath:

Inline style toolbar

You can also apply style utilizing the following hot-keys:

Hot-key Text style
Ctrl-B Bold
Ctrl-I Italic
Ctrl-U Underline
Alt-Shift-5 Strikethrough
Ctrl-Shift-Minus Subscript
Ctrl-Shift-Equal Superscript
Ctrl-\ Clear formatting
Ctrl-1 Heading 1
Ctrl-2 Heading 2
Ctrl-3 Heading 3
Ctrl-4 Heading 4
Ctrl-5 Heading 5
Ctrl-6 Heading 6
Ctrl-0 Regular paragraph

Finding missing text

By default, Conradish will automatically filter out contents it deems irrelevant. Sometimes bylines and dates can be removed as a result. To see what got filtered out, choose "Scrubbing" in the Action drop-down in the side-bar.

Action drop-down

Initial view:

Initial view

With hidden contents shown:

Complete view

Filtered contents will appear in red. Contents that Conradish thinks are questionable (but chose to keep) will pulsate in yellow. Click on a red section to restore it. Click on a section that isn't red to hide it. When you're done, click the Finish button or choose "Annotating" in the Action drop-down.

You can toggle between scrubbing and annotation mode by pressing the hot-key Ctrl-Shift-H.

Use the double checkmark button at the lower right-hand corner to restore all hidden sections:

Keep all button

Adjusting filter behavior

Conradish's filter setting determines the initial mode when you open a document. When filtering is set to automatic, the editor starts in annotation mode, with suspected junks hidden. When filtering is set to manual, the editor starts in scrubbing mode, allowing you to immediately correct the extension's findings. When filtering is turned off, the editor starts in annotation mode, with suspected junks visible.

Depending on the web sites you visit, one of these settings will prove more convenient than the others. When a site provides a print stylesheet, filtering is generally not necessary. On the other hand, when a site intermingles a lot of ads and asides with the main article text, or the page layout leads to selection of navigational elements, then leaving it turned on is advisable.

To change the filter setting, click Chrome's extension button in the toolbar then the "kebab" button for Conradish. In the menu, choose Options:

Extension menu

Conradish's options page will open up in a new tab:

Options

Permitting large headings

By default, Conradish reduces H1 headings in articles to H2, a size more suitable for the printed page. If you wish to leave them as-is, uncheck the Limit heading size checkbox.

Options

Selecting additional fonts

To make additional fonts available, click Fonts in the side-bar, then the name of the applicable script (e.g. Arabic). Check the checkbox beside the font that you want to be able to use. Uncheck the checkbox if you don't want to see it listed. You can find a font using the search box at the top of the page if you know the name.

Options

Printing

To print, click the Print button. Chrome's print window will appear. Double-check that Paper size matches what is set in Conradish and that Margins is set to "Default". The document will not print correctly if either one of these is off.

Print window

Finding documents

To find a document you had created earlier, activate the extension's pop-up menu and choose Show all documents:

Pop-up menu

Documents are arranged by date. If you remember particular keywords, you can narrow the search by entering them into the search box.

Search results

Changing document title

To change the title of a document, click on the "kebab" button beside the title and choose Change title:

Kebab menu

If you're in the middle of annotating a document, right click on the page margin (or anywhere else outside the text) and choose Change title:

Context menu

Creating inflection tables

For selected languages, Conradish can create tables containing inflected forms of footnoted words. To create such a document, activate the extension's pop-up menu and choose Show all documents:

Pop-up menu

Select the documents from which words will be taken. You can select more than one.

Document list

Then click the Create inflection tables button:

Document list

A dialog box will appear, where you can select the word categories to include in the resulting document. Click Create to create it:

Document list

The new document will appear in a new tab:

Inflection tables

The following languages are supported currently:

Slavic Romance Germanic Uralic
Bulgarian Catalan Dutch Finnish
Croatian French German
Macedonian Galician
Russian Italian
Serbian Portuguese
Slovak Spanish
Ukrainian

Copying article to Microsoft Word

To copy an article to Microsoft Word, right click on the document and choose "Select All" (or press Ctrl-A):

Context menu

Right click again and choose "Copy" (or press Ctrl-C):

Context menu

In Word, create a new document then click the Paste icon in the tool bar (or press Ctrl-V):

Microsoft Word

The text of the article, along with footnotes you've added, will now appear in Word:

Microsoft Word

Note that the online version of Word currently does not correctly handle the attached footnotes. Only the offline version of Microsoft Word works. WPS Office Writer does as well.

Limitations

  • User interface not yet optimized for touch screens.

These issues will be addressed in future versions.

Privacy

Conradish does not capture any user information. It does not monitor your browsing history. All data is stored locally. The extension does send text to Google for the purpose of translation. The privacy implications are the same as those of using Google Translate. When you install the extension, the browser will warn that it can access "your data" at translate.googleapis.com. The data in question is just translated phrases.

Support

If you have any questions or suggestions concerning this extension, feel free to contact me at [email protected].

conradish-x's People

Contributors

chung-leong avatar

Stargazers

 avatar

Watchers

 avatar  avatar  avatar

conradish-x's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.