Coder Social home page Coder Social logo

atom-gmail's Introduction

atom-gmail

Use Atom to send emails through Gmail.

This is still in Alpha. It works great for me, but there are probably still bugs. I suggest sending an email to yourself before your intended recipient

Installation

First install the package by going to Settings > Install > atom-gmail or with apm install atom-gmail from the command line.

Then you need to download credentials from your Gmail account.

  • Use this wizard to create or select a project in the Google Developers Console and automatically turn on the API. Click Continue, then Go to credentials.
  • On the Add credentials to your project page, click the Cancel button.
  • At the top of the page, select the OAuth consent screen tab. Select an Email address, enter a Product name if not already set, and click the Save button.
  • Select the Credentials tab, click the Create credentials button and select OAuth client ID.
  • Select the application type Other, enter the name "Gmail API Quickstart", and click the Create button.
  • Click OK to dismiss the resulting dialog.
  • Click the file download (Download JSON) button to the right of the client ID.
  • Copy and paste the contents of this file to the Client Secret field in the configuration settings of this package. (I.e. Settings > atom-gmail > Client Secret)

To finish the authentication, open up the command palette (either ctrl+shift+P or cmd+shift+P) and select Atom Gmail: Authenticate. It should open up a Google website in your web browser where you'll need to sign in and approve this application. You'll then have to paste the code Google gives you back into the input box in Atom. This step is buggy; for me the input box disappears the first time I run Atom Gmail: Authenticate, but it works the second time.

Usage

Header

The metadata for the email must be written in a YAML header at the top of the document. The initial --- must be the first three characters of the document and on its own line. There must be --- on a line by itself at the end of the YAML.

The available fields in the YAML header are:

  • to:
  • subject: (optional)
  • from: (optional; by default it uses the Gmail account you've signed into.)
  • cc: (optional)
  • bcc: (optional)

For example:

---
to:
  - [email protected]
  - [email protected]
cc: [email protected]
from: [email protected]
subject: This email is from Atom!
---

Content

The rest of the document should be written in standard CommonMark Markdown. See example.md for an example document, and see Markdown Extensions for a list of optional extensions to the Markdown specification.

Formatting

By default, this package applies Github Markdown styling to text. At this point, document styling cannot be changed, except for a few small tweaks exposed in the package settings.

By default Github-like styling is also applied to code; the code syntax highlighting style can be changed with the "Code highlighting style" option in the settings.

Markdown Extensions

This package uses markdown-it as its markdown parser. Therefore, any markdown-it plugin can be supported. Extension support hasn't been implemented as of March 12; add an issue to ping me about it.

Sending the Email

Open up the command palette (either ctrl+shift+P or cmd+shift+P) and start typing Atom Gmail: Send Email. The fuzzy search will find the command without having to type that text exactly.

Todo

  • Mathjax support
  • Attachment support
  • Support replies

atom-gmail's People

Contributors

kylebarron avatar

Stargazers

 avatar

Watchers

 avatar  avatar  avatar

atom-gmail's Issues

Add some style package options

Such as centered or not, min width, max width.

By default have max width at 720px. That's 80 char width on my screen. Check that on another screen.

<style>
	.markdown-body {
		box-sizing: border-box;
		min-width: 200px;
		max-width: 980px;
		margin: 0 auto;
		padding: 45px;
	}

	@media (max-width: 767px) {
		.markdown-body {
			padding: 15px;
		}
	}
</style>

Uncaught Client Secret field in configuration is empty.

[Enter steps to reproduce:]

  1. ...
  2. ...

Atom: 1.31.2 x64
Electron: 2.0.7
OS: Microsoft Windows 10 Home Single Language
Thrown From: atom-gmail package 0.1.2

Stack Trace

Uncaught Client Secret field in configuration is empty.

At C:\Users\Sanjay\.atom\packages\atom-gmail\lib\main.js:233

undefined

Commands

  2x -6:31.8.0 window:toggle-full-screen (input#core.autoHideMenuBar.input-checkbox)
  5x -6:26 window:toggle-menu-bar (input#core.autoHideMenuBar.input-checkbox)
     -6:14.2.0 core:move-down (input#core.autoHideMenuBar.input-checkbox)
  2x -6:13.7.0 core:move-up (input#core.autoHideMenuBar.input-checkbox)
     -6:11.7.0 window:toggle-menu-bar (input#core.autoHideMenuBar.input-checkbox)
  2x -3:59.6.0 core:backspace (input.hidden-input)
  2x -1:56.4.0 atom-clock:toggle (input.hidden-input)
  3x -1:34.2.0 core:backspace (input.hidden-input)
     -0:41 command-palette:toggle (div.package-detail.panels-item)
     -0:36.1.0 editor:consolidate-selections (input.hidden-input)
     -0:36 core:cancel (input.hidden-input)
     -0:34.1.0 command-palette:toggle (div.package-detail.panels-item)
     -0:28.5.0 editor:consolidate-selections (input.hidden-input)
     -0:28.5.0 core:cancel (input.hidden-input)
     -0:24.5.0 command-palette:toggle (div.package-detail.panels-item)
     -0:17.2.0 atom-gmail:authenticate (div.package-detail.panels-item)

Non-Core Packages

atom-clock 0.1.16 
atom-gmail 0.1.2 

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.