updated the README
This commit is contained in:
71
README.md
71
README.md
@@ -1,5 +1,21 @@
|
|||||||
# What Can Publify Do?
|
# What Can Publify Do?
|
||||||
|
|
||||||
|
The coolest thing `publify` can do is publish a folder of static web pages and supporting assets to the web using Netlify, including adding a custom subdomain!
|
||||||
|
|
||||||
|
Here's the full menu, though, with more details under the headings below:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
> pub help
|
||||||
|
|
||||||
|
Usage:
|
||||||
|
pub help
|
||||||
|
pub <rootpath> [<custom_domain>] --------------------------------> deploy a site
|
||||||
|
pub list -------------------------------> list all sites
|
||||||
|
pub custom <custom_domain> <existing_domain> --------------------------> set a custom domain
|
||||||
|
pub remove-custom <custom_domain> -----------------------> remove a custom domain
|
||||||
|
pub delete/remove <domain or custom_domain> --------------------------------> delete a site
|
||||||
|
```
|
||||||
|
|
||||||
## Publish Sites to Netlify via CLI!
|
## Publish Sites to Netlify via CLI!
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
@@ -30,10 +46,57 @@ the site is published: http://642718842cb34f02bc6b0137--cheery-daifuku-f3417f.ne
|
|||||||
the site is published at dudette.helpers.fun.
|
the site is published at dudette.helpers.fun.
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## List All Your Sites!
|
||||||
|
|
||||||
|
```bash
|
||||||
|
> pub list
|
||||||
|
|
||||||
|
sites without custom domains:
|
||||||
|
|
||||||
|
cheery-daifuku-f3417f: https://cheery-daifuku-f3417f.netlify.app
|
||||||
|
preeminent-salamander-6262a7: http://preeminent-salamander-6262a7.netlify.app
|
||||||
|
scintillating-mochi-760bd3: https://scintillating-mochi-760bd3.netlify.app
|
||||||
|
transcribely: https://transcribely.netlify.app
|
||||||
|
|
||||||
|
sites with custom domains:
|
||||||
|
|
||||||
|
euphonious-torrone-029b78: https://shucks.helpers.fun
|
||||||
|
flourishing-sherbet-8f356e: https://dudettes.helpers.fun
|
||||||
|
beautiful-meerkat-95c24f: https://duasdfdes.helpers.fun
|
||||||
|
glittery-khapse-b51104: https://dudes.helpers.fun
|
||||||
|
velvety-cobbler-d4e023: https://mama.helpers.fun
|
||||||
|
playful-treacle-6fea54: https://okay.helpers.fun
|
||||||
|
calm-dodol-b7aea3: https://thedonkey.helpers.fun
|
||||||
|
```
|
||||||
|
|
||||||
## Add A Custom Subdomain To An Already Published Site!
|
## Add A Custom Subdomain To An Already Published Site!
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
> pub custom hey.helpers.fun startling-gingersnap-425138.netlify.app
|
> pub custom hey.helpers.fun preeminent-salamander-6262a7.netlify.app
|
||||||
|
the site is published at hey.helpers.fun. (originally 'preeminent-salamander-6262a7.netlify.app')
|
||||||
|
```
|
||||||
|
|
||||||
|
You can also provide partial names for the Netlify URLs, and also for the custom domains if you only have one domain listed in `NETLIFY_DOMAINS`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
> pub custom hey preeminent
|
||||||
|
the site is published at hey.helpers.fun. (originally 'preeminent-salamander-6262a7.netlify.app')
|
||||||
|
```
|
||||||
|
|
||||||
|
## Remove a Custom Subdomain!
|
||||||
|
|
||||||
|
```bash
|
||||||
|
> pub remove-custom hey
|
||||||
|
'hey.helpers.fun' was removed
|
||||||
|
```
|
||||||
|
|
||||||
|
## Delete An Entire Site!
|
||||||
|
|
||||||
|
Powerful stuff:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
> pub delete preeminent
|
||||||
|
site 'http://preeminent-salamander-6262a7.netlify.app' was deleted
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
@@ -44,3 +107,9 @@ To do this magic, you have to first
|
|||||||
1) Create an environment variable `NETLIFY_TOKEN`, obtained [here](https://app.netlify.com/user/applications#personal-access-tokens).
|
1) Create an environment variable `NETLIFY_TOKEN`, obtained [here](https://app.netlify.com/user/applications#personal-access-tokens).
|
||||||
1) Create an environment variable `NETLIFY_DOMAINS`, with comma-separated values (no spaces), if you're planning to use custom domains.
|
1) Create an environment variable `NETLIFY_DOMAINS`, with comma-separated values (no spaces), if you're planning to use custom domains.
|
||||||
1) Delegate DNS management of all domains listed in `DOMAINS` to Netlify ([link](https://docs.netlify.com/domains-https/netlify-dns/delegate-to-netlify/))
|
1) Delegate DNS management of all domains listed in `DOMAINS` to Netlify ([link](https://docs.netlify.com/domains-https/netlify-dns/delegate-to-netlify/))
|
||||||
|
|
||||||
|
# TODO
|
||||||
|
|
||||||
|
- [ ] add support for partial updates, so it's not only about subdomains, but also `/sub-pages`
|
||||||
|
- [ ] add some color and spinners to the CLI using Rich
|
||||||
|
|
||||||
|
|||||||
@@ -65,7 +65,7 @@ def cli_set_custom_domain(custom_domain: str, domain: str) -> None:
|
|||||||
"""
|
"""
|
||||||
check_that_custom_domain_is_not_in_use(custom_domain)
|
check_that_custom_domain_is_not_in_use(custom_domain)
|
||||||
try:
|
try:
|
||||||
site_id, _ = get_site_id_from_netlify_domain(domain)
|
site_id, domain = get_site_id_from_netlify_domain(domain)
|
||||||
except NoResult:
|
except NoResult:
|
||||||
print(f"No site found with domain '{domain}'")
|
print(f"No site found with domain '{domain}'")
|
||||||
return
|
return
|
||||||
|
|||||||
Reference in New Issue
Block a user