cpmd

copy or move markdown files (supporting wildcard characters) to the destination directory with their attached images usually located on sub dir named 'assets', 'images' or '$filename'. the application has been published into https://www.npmjs.com/package/cpmd. By the way, An awesome editor Typora is recommended, if you also like writing in markdown.

Quick Start

• Install: install command line tool 'cpmd' (copy markdown)

$ npm install cpmd -g

• Single Copy: copy a single file named 'README.md' with its referenced image 'assets/image-20190625115442118.png' into the existed dir 'backup' in long term format.

$ cpmd --src README.md --dst backup/

src file wildcard: README.md
src file list: README.md
cp assets/image-20190625115442118.png to /Users/downgoon/Documents/backup
cp README.md to /Users/downgoon/Documents/backup

• Single Move: move a single file in short term format. the additional argument '-m' or --move indicates a moving operation rather than copying.

$ cpmd -s README.md -d backup/ -m
src file wildcard: README.md
src file list: README.md
mv assets/image-20190625115442118.png to /Users/downgoon/Documents/backup/
mv README.md to /Users/downgoon/Documents/backup/

• Multi Copy/Move: copy two files named 'README.md' and 'REMORE.md'.

$ cpmd -s 'RE*.md' -d backup/  
src file wildcard: RE*.md
src file list: README.md,REMORE.md
cp assets/image-20190625115442118.png to /Users/downgoon/Documents/backup/
cp README.md to /Users/downgoon/Documents/backup/
cp REMORE.md to /Users/downgoon/Documents/backup/

$ tree .   # the two files' layout
.
├── README.md
├── REMORE.md
└── assets
    └── image-20190625115442118.png

NOTE: wildcard src fie name like 'RE*.md' MUST be quoted by single quotation marks '.

• hexo-style copy: in hexo, Asset folder will have the same name as the markdown file associated with the post. Place all assets related to your post into the associated folder, and you will be able to reference them using a relative path, making for an easier and more convenient workflow. For example:

  • before coping, source layout of the markdown file and its attached images

  $ tree .
  ├── README.md
  ├── assets
  │   ├── image-20190708204512742.png

  • after copying, destination layout

  $ cpmd -s README.md -d hexo-blog/source/_post/ --hexo
  
  $ tree hexo-blog/source/_post/ 
  ├── README
  │   └── image-20190708204512742.png
  ├── README.md

• Help Info: for help information, please type cpmd -h or cpmd directly

$ cpmd
copy/move markdown files supporting wildcard characters to the destination directory **with its/their attached images** on local file paths
Usage(Long Term): cpmd --src <$src.md> --dst <$dstdir> [--move]
Usage(Short Term): cpmd -s <$src.md> -d <$dstdir> [-m]
Multi Copy Example: cpmd -s 'RE*.md' -d backup/

$ cpmd -h
Options:
  -V, --version    output the version number
  -s, --src <src>  src markdown files (supporting wildcard characters)
  -d, --dst <dst>  dst directory
  -m, --move       move flag, default value is false
  -h, --help       output usage information

---

Developer Guide

Quick Start

$ git clone git@github.com:downgoon/cpmd.git
$ cd cpmd
$ npm install   # download dependencies and save them into 'node_modules'
$ node cpmd.js  # debug
$ mkdir backup  # create a directory at which markdown files will be placed
$ node cpmd.js -s './test/REMORE.md' -d backup/ --hexo # test hexo-style copy

local install

• package.json introduction

{
  "name": "cpmd",
  "version": "0.1.0", // version number, default is 1.0.0
  "description": "copy markdown file to the destination directory with its attached images on local file paths",
  "main": "cpmd.js",   // entry point of the application, default is 'Index.js'
  "dependencies": { // auto added on 'npm install $module_name --save' executed
    "command-line-args": "^5.1.1",
    "commander": "^2.20.0",
    "fs-extra": "^8.0.1",
    "markdown-parser": "0.0.8"
  },
  "repository": {
    "type": "git",
    "url": "git://github.com/downgoon/cpmd.git"
  },
  "bin": {  // cmd line name for 'npm install . -g'
    "cpmd": "cpmd.js" // cmd line name -> js reference
  },
  "devDependencies": {},
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "downgoon@qq.com",
  "license": "MIT"
}

the bin section is required for local installation in which the command like npm install . -g will be executed.

• directive head line: #!/usr/bin/env node

Add the following directive, which is also required, at the first line of "cpmd.js" file whose content is just like this:

#!/usr/bin/env node

var fs = require('fs');
var fse = require("fs-extra");
var Parser = require('markdown-parser');
const path = require("path");

• locally install

$ sudo npm uninstall . -g  # uninstall previous version
$ sudo npm install . -g  # install local new version
/usr/local/bin/cpmd -> /usr/local/lib/node_modules/cpmd/cpmd.js
+ cpmd@0.1.0
updated 1 package in 0.161s
$ which cpmd
/usr/local/bin/cpmd
$ ll /usr/local/bin/ | grep cpmd
cpmd -> ../lib/node_modules/cpmd/cpmd.js

• cmd line testing

$ cpmd
Usage: mdcp --src $src.md --dst $dstdir

remote install

• publish firstly: publish the application to the official site www.npmjs.com

$ npm login   # please signup an account firstly
Username: downgoon
Password:  # input your password hear
Email: (this IS public) downgoon@qq.com
Logged in as downgoon on https://registry.npmjs.org/.


$ npm publish   # publish to registry.npmjs.org

npm publish
npm notice
npm notice 📦  cpmd@0.1.0
npm notice === Tarball Contents ===
npm notice 686B  package.json
npm notice 2.0kB cpmd.js
npm notice 2.9kB README.md
npm notice === Tarball Details ===
npm notice name:          cpmd
npm notice version:       0.1.0
npm notice package size:  2.1 kB
npm notice unpacked size: 5.6 kB
npm notice shasum:        7cc7dc6378216e3bb4ad6fc15d4a2511f18aecf7
npm notice integrity:     sha512-Lki/LCZBB7sp8[...]OCYpIyhyDtB+A==
npm notice total files:   3
npm notice
+ cpmd@0.1.0

$ npm view cpmd  # view the published detail info

cpmd@0.1.0 | MIT | deps: 4 | versions: 1
copy markdown file to the destination directory with its attached images on local file paths
https://github.com/downgoon/cpmd#readme

bin: cpmd

dist
.tarball: https://registry.npmjs.org/cpmd/-/cpmd-0.1.0.tgz
.shasum: 7cc7dc6378216e3bb4ad6fc15d4a2511f18aecf7
.integrity: sha512-Lki/LCZBB7sp8aOt8wTHtJ8sgMmEt25WgRXM4iQmytNSEbBF0dkL9+aomsvgIrGuCXtkyR2GJOCYpIyhyDtB+A==
.unpackedSize: 5.6 kB

dependencies:
command-line-args: ^5.1.1 commander: ^2.20.0        fs-extra: ^8.0.1          markdown-parser: 0.0.8

maintainers:
- downgoon <downgoon@qq.com>

dist-tags:
latest: 0.1.0

published 39 seconds ago by downgoon <downgoon@qq.com>

• remotely install: download from 'registry.npmjs.org' and install

$ npm install cpmd -g
/usr/local/bin/cpmd -> /usr/local/lib/node_modules/cpmd/cpmd.js
+ cpmd@0.1.0
updated 12 packages in 3.2s