Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shahednasser/cross-post
Cross Post a blog to multiple websites
https://github.com/shahednasser/cross-post
blog blogging cli hacktoberfest npm npm-cli package writing writing-tool
Last synced: 5 days ago
JSON representation
Cross Post a blog to multiple websites
- Host: GitHub
- URL: https://github.com/shahednasser/cross-post
- Owner: shahednasser
- License: mit
- Created: 2021-03-24T12:07:49.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-09-22T01:20:08.000Z (about 1 year ago)
- Last Synced: 2024-10-23T07:18:14.583Z (14 days ago)
- Topics: blog, blogging, cli, hacktoberfest, npm, npm-cli, package, writing, writing-tool
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/cross-post-blog
- Size: 644 KB
- Stars: 123
- Watchers: 3
- Forks: 16
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - shahednasser/cross-post - Cross Post a blog to multiple websites (JavaScript)
README
# Cross Post
[](./LICENSE) [](https://badge.fury.io/js/cross-post-blog)
[](https://www.buymeacoffee.com/shahednasser)
Easily cross post your article on dev.to, Hashnode and Medium from your terminal.
- [Installation](#installation)
- [Installation of MacOS with M1 chip](#installation-of-macos-with-m1-chip)
- [Method 1: Rosetta Terminal](#method-1-rosetta-terminal)
- [Method 2](#method-2)
- [Usage](#usage)
- [Set Configuration](#set-configuration)
- [dev.to](#devto)
- [Hashnode](#hashnode)
- [Medium](#medium)
- [Cross Posting Your Articles](#cross-posting-your-articles)
- [Cross Posting Local Markdown Files](#cross-posting-local-markdown-files)
- [Selector Configuration](#selector-configuration)
- [Image Selector Configuration](#image-selector-configuration)
- [Title Selector Configuration](#title-selector-configuration)
- [Uploading Data URI Article Images](#uploading-data-uri-article-images)
- [Using a Cloudinary account](#using-a-cloudinary-account)
- [Pass Image URL](#pass-image-url)
- [Post Article Without Image](#post-article-without-image)
- [Reset Configuration](#reset-configuration-values)
- [License](#license)
## Installation
In your terminal:
```bash
npm i -g cross-post-blog
```
### Installation of MacOS with M1 chip
For Apple M1, it's best to have Node v14.
There are two ways to install this package on a MacOS with M1 chip:
#### Method 1: Rosetta Terminal
1. If you don't have a Rosetta Terminal, go to Finder, then in the menu bar go to Go > Utilities. Duplicate "Terminal" and rename it to "Rosetta Terminal" or anything you want. Then click on the duplicate you create it and press "command + I" and choose "Open using Rosetta".
2. Open the Rosetta Terminal you created, uninstall and then install Node again.
3. Install this package again.
#### Method 2
1. In the terminal run: arch -arm64 brew install pkg-config cairo pango libpng jpeg giflib librsvg
2. Try installing this package again.
You might also need to add the following to `~/.zshrc`:
```bash
export PKG_CONFIG_PATH="/opt/homebrew/Cellar:/opt/homebrew/lib/pkgconfig:/opt/homebrew/share/pkgconfig"
```
## Usage
### Set Configuration
For the simplicity of the CLI, and considering most of the APIs of each of the platforms do not allow or provide endpoints for user authentication, you will need to get your access tokens, api keys or integration tokens from your own profile before using cross post. This will just need to be done the first time or if you want to change the tokens.
**The tokens are all stored on your local machine.**
Here's a guide on how to do this for each of the platforms:
### dev.to
1. After logging into your account on dev.to, click on your profile image and then click on Settings
2. Then, click on the Accounts tab in the sidebar
3. Scroll down to the "DEV Community API Keys" section. You need to generate a new key. Enter "Cross Post" in the description text box or any name you want then click "Generate API key"
Copy the generated API key, then in your terminal:
```bash
cross-post config dev
```
You'll be prompted to enter the API key. Paste the API key you copied earlier and hit enter. The API key will be saved.
### Hashnode
1. After logging into your account on Hashnode, click on your profile image and then click on "Account Settings"
2. In the sidebar click on "Developer"
3. Click the "Generate" button and then copy the generated access token.
4. Run the following in your terminal:
```bash
cross-post config hashnode
```
First you'll be prompted to enter your access token. Then, you need to enter your Hashnode username. The reason behind that is that when later posting on hashnode your publication id is required, so your username will be used here to retreive the publication id. Once you do and everything goes well, the configuration will be saved successfully.
### Medium
1. After logging into Medium, click on your profile image and then click on "Settings"
2. Then click on "Integration Tokens" in the sidebar
3. You have to enter description of the token then click "Get integration token" and copy the generated token.
4. In your terminal run:
```bash
cross-post config medium
```
Then enter the integration token you copied. A request will also be sent to Medium to get your authorId as it will be used later to post your article on Medium. Once that is done successfully, your configuration will be saved.
### Cross Posting Your Articles
To cross post your articles, you will use the following command:
```bash
cross-post run [options]
```
Where `url` is the URL of your article that you want to cross post. `options` can be:
1. `-p, --platforms [platforms...]` The platform(s) you want to post the article on. By default if this option is not included, it will be posted on all the platforms. An example of its usage:
```bash
cross-post run -p dev hashnode
```
2. `-t, --title [title]` The title by default will be taken from the URL you supplied, however, if you want to use a different title you can supply it in this option.
3. `-s, --selector [selector]` by default, the `selector` config value or the `article` selector will be used to find your article in the URL you pass as an argument. However, if you need a different selector to be used to find the article, you can pass it here.
4. `-pu, --public` by default, the article will be posted as a draft (or hidden for hashnode due to the limitations of the Hashnode API). You can pass this option to post it publicly.
5. `-i, --ignore-image` this will ignore uploading an image with the article. This helps avoid errors when an image cannot be fetched.
6. `-is, --image-selector [imageSelector]` this will select the image from the page based on the selector you provide, instead of the first image inside the article. This option overrides the default image selector in the configurations.
7. `-iu, --image-url [imageUrl]` this will use the image URL you provide as a value of the option and will not look for any image inside the article.
8. `-ts, --title-selector [titleSelector]` this will select the title from the page based on the selector you provide, instead of the first heading inside the article. This option overrides the default title selector in the configurations.
This command will find the HTML element in the URL page you pass as an argument and if found, it will extract the title (if no title is passed in the arguments) and cover image.
#### Cross Posting Local Markdown Files
Starting from version 1.2.3, you can now post local markdown files to the platforms. Instead of passing a URL, pass the path to the file with the option `-l` or `--local`.
For example:
```bash
cross-post run /path/to/test.md -l
```
You can also use any of the previous options mentioned.
#### Selector Configuration
If you need this tool to always use the same selector for the article, you can set the default selector in the configuration using the following command:
```bash
cross-post config selector
```
Then, you'll be prompted to enter the selector you want. After you set the default selector, all subsequent `run` commands will use the same selector unless you override it using the option `--selector`.
#### Image Selector Configuration
If you need this tool to always use the same selector for the image, you can set the default image selector in the configuration using the following command:
```bash
cross-post config imageSelector
```
Then, you'll be prompted to enter the image selector you want. After you set the default image selector, all subsequent `run` commands will use the same selector unless you override it using the option `--image-selector`.
#### Title Selector Configuration
If you need this tool to always use the same selector for the title, you can set the default title selector in the configuration using the following command:
```bash
cross-post config titleSelector
```
Then, you'll be prompted to enter the title selector you want. After you set the default title selector, all subsequent `run` commands will use the same selector unless you override it using the option `--title-selector`.
#### Uploading Data URI Article Images
If your website's main article image is a [Data URL image](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs), uploading it as it is would lead to an error on most platforms. There are 3 ways to avoid that:
##### Using a Cloudinary account
In this method, you'll need to create or use an already created Cloudinary account and the tool will use the account to upload the image and get a URL.
Follow the steps below:
1. Create a [Cloudinary](https://cloudinary.com) account.
2. Get the `cloud_name`, `api_key`, and `api_secret` from your account.
3. Run `cross-post config cloudinary` and enter the information as prompted. **Remember that all keys are stored on your local machine**.
That's it. Next time you run the `cross-post run` command, if the image is a Data URL image, it will be uploaded to Cloudinary to get a URL for it. You can delete the image once the article has been published publicly on the platforms.
##### Pass Image URL
You can pass an image URL as an option to `cross-post run` using `--image-url`.
##### Post Article Without Image
You can pass the option `--ignore-image` to `cross-post run` and the article will be published without an image.
#### Reset Configuration Values
you can reset configuration values for each platform like this
```bash
cross-post config reset
```
for example,
```bash
cross-post config reset dev
```
will reset all configuration values for dev.to platform
All available reset commands are
```markdown
Commands:
dev reset configuration for dev.to
medium reset configuration for medium.com
hashnode reset configuration for hashnode.com
cloudinary reset configuration for cloudinary
all reset all *non-platform* configuration
```
The command `cross-post config reset all` or simply, `cross-post config reset` will reset every configuration value except the platform configuration values.
---
## License
MIT