save-as-heading

save-as-heading is use the first line as the file name to quickly create or overwrite the file.

Installation

Atom Package: https://atom.io/packages/save-as-heading

apm install save-as-heading

Feature

• this package is use filename at first line to override or create file.
• or, this package is use file name of heading line (e.g. #) of markdown, override or create file.
• Using markdown and txt, can quickly create a document for each file.

Usage

Example1

1. input the next sentence.

title
foo bar fuga.
...
...

1. ctrl + shift + h
2. A file name title.md is created or overrided. > to change .md to Setting - Extension

Example2

1. input the next sentence.

/directory/directory/title
foo bar fuga.
...
...

1. ctrl + shift + h
2. A file path /directory/directory/title.md is created or overrided. a root of the path is the project folder.

Example3

1. set a Setting - Filename type is Headline.
2. input the next sentence.

...
title
# head1
foo bar fuga.
...
...

1. ctrl + shift + h
2. A file name head1.md is created or overrided.

Example4

1. set a Setting - Filename type is Metadata.
2. input the next sentence.

title: This would be wonderful
date: 2018-07-31
publish: true

This is a new file, i'm about to save it with `ctrl+shift+H`.

1. ctrl + shift + h
2. A file name This-would-be-wonderful.md is created or overrided. > to change key in Metadata to Setting - Key in Metadata (e.g. %date%-%title%).

Options

• Extension
  • save a file name of extension.
  • default .md.
• Filename type
  • Firstline
    • the first line is used in the filename.
  • Headline
    • the heading line (e.g. #) of markdown is used in the filename.
  • Metadata
    • the Markdown Metadata is used in filename. Refer to this setting is Key in Metadata.
  • default Firstline.
• Filename key in Metadata
  • set any character enclosed by the percent(%) is the key for the filename(e.g. %date%,%date%-%title%).
  • default %date%.
• Show save success notification
  • show/hide notification when saved file.
• Replace from / Replace to
  • Replace from
    • replace in title when save a filename(default:space). if use multiple chars, separate them with | (ex:_| |-)
  • Replace to
    • replace [Replace from] with [Replace to] in filename when saved.
      
  • example 1
    • Replace from = (spaces) , Replace to = - txt /directory/first line code saved file path in /directory/first-line-code.md
  • example 2
    • Replace from = (spaces)|, , Replace to = - txt /directory/first line code,to file name saved file path in /directory/first-line-code-to-file-name.md
• Conversion filename
  • convert Uppercase Lowercase Capitalize in filename when saved.
  • example
    • Conversion filename = Capitalize txt /directory/first-line-ccode saved file path in /directory/First-line-code.md

Licence

MIT

Author

trashfeed