Giter Club home page Giter Club logo

abricotine's Introduction

Abricotine

A markdown editor for desktop

Screenshot

In Abricotine, you can preview your document directly in the text editor rather than in a side pane.

Another screenshot

Abricotine is an open-source software based on modern web technologies (HTML5, CSS3 & Node.js).

Features

  • Write in markdown (or GFM) and export your documents in HTML,
  • Preview text elements (such as headers, images, math, embedded videos, todo lists...) while you type,
  • Display document table of content in the side pane,
  • Display syntax highlighting for supported languages (HTML, XML, CSS, Javascript, and more to come...),
  • Show helpers, anchors and hidden characters,
  • Copy formatted HTML in the clipboard,
  • Write in a distraction-free fullscreen view,
  • Manage and beautify markdown tables,
  • Search and replace text,
  • And more features to come...

Abricotine is still in beta development. If you find a bug please report it in the dedicated bug tracker.

Installation and usage

Abricotine is working on Windows (7 and later), Linux and OSX.

Installation from binaries

For Windows and Linux users, the following installation method is recommended:

  1. Download prebuilt binaries from the Releases page,
  2. Extract the archive,
  3. Run Abricotine.exe (on Windows) or Abricotine (on Linux).

Installers are not released yet.

For OS X users, you must have Homebrew and Hombrew Cask installed. The run:

brew cask install abricotine

Building and packaging

Requirements

  • Node.js and npm,
  • Make sure you meet node-gyp requirements (specific to your platform and architecture),
  • git (for Bower installation).

Building

  1. Install requirements,
  2. Download the latest Abricotine release source and extract the archive,
  3. Run $ npm install in the extracted folder.
  4. You can use Abricotine by running $npm start from its directory. To open a specific file, run $npm start -- [path-to-file].

Packaging

Run $ npm run packager from the built project directory and select your platform and architecture.

Packages are created in the dist directory.

Configuration

You can open and edit Abricotine JSON configuration file by clicking "Edit preferences" in the "Edit" menu.

Most of the configuration entries are already handled by menus so you do not need to edit a file for changing them. However there is no menu for editing the following options:

autopreview-security

If set to true, only iframes loaded from domains listed in autopreview-domains will be previewed.

Default is true.

autopreview-domains

Contains the list of domains considered as safe when previewing iframes (see autopreview-security).

Default:

 "autopreview-domains": [
     "dailymotion.com",
     "deezer.com",
     "dribbble.com",
     "facebook.com",
     "github.com",
     "google.com",
     "instagram.com",
     "pinterest.com",
     "soundcloud.com",
     "spotify.com",
     "twitter.com",
     "vimeo.com",
     "youtube.com"
]

Adding spell checker dictionaries

Abricotine uses hunspell dictionaries for Linux and Windows 7. If you want to add dictionaries, simply drop the dictionary folder in the dict subdirectory of Abricotine configuration folder.

Otherwise Abricotine uses the OS builtIn dictionaries when supported.

Contributing

Abricotine is an open source program. Feel free to fork and contribute.

In order to keep the match between this documentation and the last release, please contribute and pull requests on the dedicated develop branch.

License

Abricotine - Markdown Editor
Copyright (c) 2015 Thomas Brouard

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

abricotine's People

Watchers

 avatar  avatar

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.