{"id":16986062,"url":"https://github.com/chung-leong/conradish-x","last_synced_at":"2025-07-08T10:06:08.394Z","repository":{"id":45286839,"uuid":"376816325","full_name":"chung-leong/conradish-x","owner":"chung-leong","description":"Chrome extension that lets you create print version of news articles with footnotes","archived":false,"fork":false,"pushed_at":"2022-09-17T14:57:34.000Z","size":22800,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T17:46:37.486Z","etag":null,"topics":["chrome-extension","foreign-language"],"latest_commit_sha":null,"homepage":"https://chrome.google.com/webstore/detail/conradish/pghjgimhknohffcjlgbhjcdmgdhfhfmk","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chung-leong.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-14T12:32:30.000Z","updated_at":"2022-09-17T14:44:57.000Z","dependencies_parsed_at":"2023-01-18T12:31:12.219Z","dependency_job_id":null,"html_url":"https://github.com/chung-leong/conradish-x","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/chung-leong/conradish-x","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chung-leong%2Fconradish-x","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chung-leong%2Fconradish-x/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chung-leong%2Fconradish-x/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chung-leong%2Fconradish-x/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chung-leong","download_url":"https://codeload.github.com/chung-leong/conradish-x/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chung-leong%2Fconradish-x/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264247790,"owners_count":23579053,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrome-extension","foreign-language"],"created_at":"2024-10-14T02:44:45.671Z","updated_at":"2025-07-08T10:06:08.372Z","avatar_url":"https://github.com/chung-leong.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Conradish\n\nConradish 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.\n\nThe 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.\n\n![Conradish transformation](doc/img/transform-1.jpg)\n\n* [Features](#features)\n* [User Guide](#user-guide)\n  - [Creating print version of article](#creating-print-version-of-article)\n  - [Annotating article](#annotating-article)\n     - [Adding definition](#adding-definition)\n     - [Adding translation/explanation](#adding-translationexplanation)\n     - [Choosing alternative translation](#choosing-alternative-translation)\n     - [Removing footnotes](#removing-footnotes)\n  - [Editing article](#editing-article)\n  - [Applying text style](#applying-text-style)\n  - [Finding missing text](#finding-missing-text)\n  - [Adjusting filter behavior](#adjusting-filter-behavior)\n  - [Permitting large headings](#permitting-large-headings)\n  - [Selecting additional fonts](#selecting-additional-fonts)\n  - [Printing](#printing)\n  - [Finding documents](#finding-documents)\n  - [Changing document title](#changing-document-title)\n  - [Creating inflection tables](#creating-inflection-tables)\n  - [Copying article to Microsoft Word](#copying-article-to-microsoft-word)\n* [Limitations](#limitations)\n* [Privacy](#privacy)\n* [Support](#support)\n\n# Features\n\n* Printing only selected portion of an article\n* Removal of ads and images\n* Simplification of page layout\n* Editing of text prior to printing\n* Point-and-click content scrubbing.\n* Addition of footnotes\n* Integration with Google Translate\n\n# User Guide\n\n## Creating print version of article\n\nTo 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**:\n\n![Context menu](doc/img/capture-1.jpg)\n\nYou 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:\n\n![Pop-up menu](doc/img/capture-2.jpg)\n\nThe print version will open up in a new browser tab:\n\n![Print version](doc/img/document-1.jpg)\n\n## Annotating article\n\n### Adding definition\n\nSelect the term for which the definition is desired. A pop-up menu will appear underneath. Choose **Add definition**:\n\n![Annotation menu](doc/img/annotate-1.jpg)\n\nIf 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:\n\n![Footnote](doc/img/footnote-1.jpg)\n\nIf the **To** language matches the **From** language or if \"None\" is selected, then you'll need to enter the definition yourself.\n\n![Footnote](doc/img/footnote-2.jpg)\n\nYou can undo the action by pressing **Ctrl-Z** on your keyboard.\n\n### Adding translation/explanation\n\nSelect the sentence you wish to be translated. A pop-up menu will appear underneath. Choose **Add translation**:\n\n![Annotation menu](doc/img/annotate-2.jpg)\n\nThe translated sentence will then appear in the page's footer:\n\n![Footnote](doc/img/footnote-3.jpg)\n\nThe **Add translation** functionality only differs from **Add definition** in that the original text is omitted in the footnote.\n\nBoth **Add definition** and **Add translation** will appear in the menu when more than one word (but less than 8) are selected.\n\n**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).\n\n### Choosing alternative translation\n\nTo choose an alternative translation, click on the definition part of a footnote and choose from the pop-up menu:\n\n![Footnote](doc/img/footnote-5.jpg)\n\n### Removing footnotes\n\nTo remove a footnote, simply delete the associated footnote number:\n\n![Footnote number](doc/img/footnote-number-1.jpg)\n\nOr delete the footnote entry:\n\n![Footnote](doc/img/footnote-4.jpg)\n\n## Editing article\n\nYou 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:\n\n![Action drop-down](doc/img/action-2.jpg)\n\nClick the **Finish** button to return to annotation mode.\n\n## Applying text style\n\nTo apply text style to the document, choose \"Styling\" in the **Action** drop-down in the side-bar:\n\n![Action drop-down](doc/img/action-3.jpg)\n\nIf 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:\n\n![Block style toolbar](doc/img/styling-1.jpg)\n\nIf you wish to bold or underline a word, select the word, then click the applicable button in the tool-bar that appears underneath:\n\n![Inline style toolbar](doc/img/styling-2.jpg)\n\nYou can also apply style utilizing the following hot-keys:\n\n| Hot-key              | Text style        |\n|----------------------|-------------------|\n| **Ctrl-B**           | Bold              |\n| **Ctrl-I**           | Italic            |\n| **Ctrl-U**           | Underline         |\n| **Alt-Shift-5**      | Strikethrough     |\n| **Ctrl-Shift-Minus** | Subscript         |\n| **Ctrl-Shift-Equal** | Superscript       |\n| **Ctrl-\\\\**          | Clear formatting  |\n| **Ctrl-1**           | Heading 1         |\n| **Ctrl-2**           | Heading 2         |\n| **Ctrl-3**           | Heading 3         |\n| **Ctrl-4**           | Heading 4         |\n| **Ctrl-5**           | Heading 5         |\n| **Ctrl-6**           | Heading 6         |\n| **Ctrl-0**           | Regular paragraph |\n\n## Finding missing text\n\nBy 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.\n\n![Action drop-down](doc/img/action-1.jpg)\n\nInitial view:\n\n![Initial view](doc/img/filter-1.jpg)\n\nWith hidden contents shown:\n\n![Complete view](doc/img/filter-2.jpg)\n\nFiltered 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.\n\nYou can toggle between scrubbing and annotation mode by pressing the hot-key **Ctrl-Shift-H**.\n\nUse the double checkmark button at the lower right-hand corner to restore all hidden sections:\n\n![Keep all button](doc/img/bk-button-1.jpg)\n\n## Adjusting filter behavior\n\nConradish'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.\n\nDepending 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.\n\nTo change the filter setting, click Chrome's extension button in the toolbar then the \"kebab\" button for Conradish. In the menu, choose **Options**:\n\n![Extension menu](doc/img/extension-menu-1.jpg)\n\nConradish's options page will open up in a new tab:\n\n![Options](doc/img/options-1.jpg)\n\n## Permitting large headings\n\nBy 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.\n\n![Options](doc/img/options-2.jpg)\n\n## Selecting additional fonts\n\nTo 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.\n\n![Options](doc/img/options-3.jpg)\n\n## Printing\n\nTo 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.\n\n![Print window](doc/img/print-1.jpg)\n\n## Finding documents\n\nTo find a document you had created earlier, activate the extension's pop-up menu and choose **Show all documents**:\n\n![Pop-up menu](doc/img/pop-up-1.jpg)\n\nDocuments are arranged by date. If you remember particular keywords, you can narrow the search by entering them into the search box.\n\n![Search results](doc/img/search-1.jpg)\n\n## Changing document title\n\nTo change the title of a document, click on the \"kebab\" button beside the title and choose **Change title**:\n\n![Kebab menu](doc/img/change-title-1.jpg)\n\nIf 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**:\n\n![Context menu](doc/img/change-title-2.jpg)\n\n## Creating inflection tables\n\nFor 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**:\n\n![Pop-up menu](doc/img/pop-up-1.jpg)\n\nSelect the documents from which words will be taken. You can select more than one.\n\n![Document list](doc/img/inflection-1.jpg)\n\nThen click the **Create inflection tables** button:\n\n![Document list](doc/img/inflection-2.jpg)\n\nA dialog box will appear, where you can select the word categories to include in the resulting document. Click **Create** to create it:\n\n![Document list](doc/img/inflection-3.jpg)\n\nThe new document will appear in a new tab:\n\n![Inflection tables](doc/img/inflection-4.jpg)\n\nThe following languages are supported currently:\n\n| Slavic     | Romance    | Germanic | Uralic  |\n|------------|------------|----------|---------|\n| Bulgarian  | Catalan    | Dutch    | Finnish |\n| Croatian   | French     | German   |         |\n| Macedonian | Galician   |          |         |\n| Russian    | Italian    |          |         |\n| Serbian    | Portuguese |          |         |\n| Slovak     | Spanish    |          |         |\n| Ukrainian  |            |          |         |\n\n## Copying article to Microsoft Word\n\nTo copy an article to Microsoft Word, right click on the document and choose \"Select All\" (or press **Ctrl-A**):\n\n![Context menu](doc/img/copy-paste-1.jpg)\n\nRight click again and choose \"Copy\" (or press **Ctrl-C**):\n\n![Context menu](doc/img/copy-paste-2.jpg)\n\nIn Word, create a new document then click the Paste icon in the tool bar (or press **Ctrl-V**):\n\n![Microsoft Word](doc/img/microsoft-word-1.jpg)\n\nThe text of the article, along with footnotes you've added, will now appear in Word:\n\n![Microsoft Word](doc/img/microsoft-word-2.jpg)\n\nNote 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.\n\n# Limitations\n\n* User interface not yet optimized for touch screens.\n\nThese issues will be addressed in future versions.\n\n# Privacy\n\nConradish 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](https://policies.google.com/privacy). 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.\n\n# Support\n\nIf you have any questions or suggestions concerning this extension, feel free to contact me at chernyshevsky@hotmail.com.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchung-leong%2Fconradish-x","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchung-leong%2Fconradish-x","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchung-leong%2Fconradish-x/lists"}