This page is for IT administers, Web masters and computer literates who have basic skills of deploying a Website or unzip a file of a software application. The files needed are available in the '''[[Download]]''' area.

The backend and the fontend should be hosted in the same host. And the DB engine is with Sqlite.

== Deploy to IIS ==

=== '''Prerequisites''' ===

# [https://dotnet.microsoft.com/en-us/download/dotnet/7.0 ASP.NET Core Runtime Hosting Bundle] for Windows IIS.
# A Website created with Application Pool of "No Managed Code".

=== Installation ===

# Extract the Zip file to the Website root folder.
# Alter bin/appsettings.json with `UseHttps: true` to enforce HTTPS.

'''Remarks:'''

* It may be beneficial to set a IIS rewrite rule in Web.config to further enforce HTTPS, while this is optional, since the app itself along with ASP.NET Core Runtime Hosting Bundle is capable of redirecting HTTP calls to HTTPS.
* Single Page Applications often have rewrite rules defined either in Web server (IIS or Apache) config for entering the app from any valid frontend routes. Web.config coming with the app supports such. However, when the app is running with Kestrel, web.config is not used.

'''Hints:'''

If you don't want to purchase a SSL certificate, you may use "[https://letsencrypt.org/ Let's Encrypt]".

== Windows Desktop App==
The releases for desktop app are basically the same as the ones for Web App, however, the release is hosted in a local Web server Kestrel included in ASP.NET Core Runtime.

=== '''Prerequisites'''===
#[https://dotnet.microsoft.com/en-us/download/dotnet/7.0 ASP.NET Core Runtime] for Windows

==='''Installation'''===
#Either install the MSI file or extract the Zip file to a desired folder.
#In folder, double click "CreateShortcut.bat" which will create a shortcut on Windows desktop. This shortcut actually runs `StartPoetryApp.ps1` which will launch PoetryApp.exe and open the default Web browser browsing [http://localhost:5000 http://localhost:5300].

You can copy or move the shortcut to any launch area of Windows.

'''Hints:'''

In case you have other apps running at port 5300, you need to change the following settings:

# File `bin/appsettings.json`: Alter Kestrel/Endpoints/Http/Url to "[http://localhost:Port http://localhost:PortNotInUse]", for example, "[http://localhost http://localhost:5310"]
#File `StartPoetryApp.ps1`: Alter respective URL of "start-process".
'''Remarks:'''

*The desktop app's backend is running on Kestrel which does not read web.config with some rewrite rules, and these rules are for entering the app from any valid frontend routes. However, because you almost always enter the frontend the first time through the startup URL, and the service worker of the frontend will then later on take care of the routing. So eventually you later can access the app from any valid frontend routes.
*Likewise, the static read only variant (Poetry Viewer) of the app also rely on the service worker for routing. Poetry Viewer is often hosted in a server without explicit backend and you may not have control of the server config for the rewrite rules.

==MacOS Desktop App==
[[File:Local app on MacOS.png|thumb|local app on MacOS]]

==='''Prerequisites'''===
#[https://dotnet.microsoft.com/en-us/download/dotnet/7.0 ASP.NET Core Runtime] for macOS Binaries Arm64 or x64. Optional. If you had installed the self contained release, you don't need to install

==='''Installation'''===
# Extract the Zip file to a desired folder, for example, "/Users/YourUsername/Documents/PoetryApp"
#[https://support.apple.com/en-au/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/2.12/mac/11.0 Apply "chmod 755" to files "StartPoetryApp.command" and "bin/PoetryApp"] to make both become executable.

===Execution===

=====In Terminal=====
#Under "/Users/YourUsername/Documents/PoetryApp", execute "./StartPoetryApp.command". And this will launch PoetryApp as a local service hosting http://localhost:5300 and open browser Safari or Chrome, and go to http://localhost:5300

=====In Finder=====

#Double click "StartPoetryApp.command".
[[File:PoetryApp Local Service.png|alt=PoetryApp Local Service|thumb|PoetryApp Local Service]]
'''Hints:'''

You may make an Alias of "StartPoetryApp.command".

2022-10-27T12:00:55Z

Admin:

Download

2022-10-27T10:16:35Z

Admin:

Deployment

2022-10-27T10:15:33Z

Admin:

This page is for IT administers, Web masters and computer literates who have basic skills of deploying a Website or unzip a file of a software application. The files needed are available in the '''[[Download]]''' area.

The backend and the fontend should be hosted in the same host. And the DB engine is with Sqlite.

== Deploy to IIS ==

=== '''Prerequisites''' ===

# [https://dotnet.microsoft.com/en-us/download/dotnet/6.0 ASP.NET Core Runtime Hosting Bundle] for Windows IIS.
# A Website created with Application Pool of "No Managed Code".

=== Installation ===

# Extract the Zip file to the Website root folder.
# Alter bin/appsettings.json with `UseHttps: true` to enforce HTTPS.

'''Remarks:'''

* It may be beneficial to set a IIS rewrite rule in Web.config to further enforce HTTPS, while this is optional, since the app itself along with ASP.NET Core Runtime Hosting Bundle is capable of redirecting HTTP calls to HTTPS.
* Single Page Applications often have rewrite rules defined either in Web server (IIS or Apache) config for entering the app from any valid frontend routes. Web.config coming with the app supports such. However, when the app is running with Kestrel, web.config is not used.

'''Hints:'''

If you don't want to purchase a SSL certificate, you may use "[https://letsencrypt.org/ Let's Encrypt]".

== Windows Desktop App==
The releases for desktop app are basically the same as the ones for Web App, however, the release is hosted in a local Web server Kestrel included in ASP.NET Core Runtime.

=== '''Prerequisites'''===
#[https://dotnet.microsoft.com/en-us/download/dotnet/6.0 ASP.NET Core Runtime] for Windows

==='''Installation'''===
#Either install the MSI file or extract the Zip file to a desired folder.
#In folder, double click "CreateShortcut.bat" which will create a shortcut on Windows desktop. This shortcut actually runs `StartPoetryApp.ps1` which will launch PoetryApp.exe and open the default Web browser browsing [http://localhost:5000 http://localhost:5300].

You can copy or move the shortcut to any launch area of Windows.

'''Hints:'''

In case you have other apps running at port 5300, you need to change the following settings:

# File `bin/appsettings.json`: Alter Kestrel/Endpoints/Http/Url to "[http://localhost:Port http://localhost:PortNotInUse]", for example, "[http://localhost http://localhost:5310"]
#File `StartPoetryApp.ps1`: Alter respective URL of "start-process".
'''Remarks:'''

*The desktop app's backend is running on Kestrel which does not read web.config with some rewrite rules, and these rules are for entering the app from any valid frontend routes. However, because you almost always enter the frontend the first time through the startup URL, and the service worker of the frontend will then later on take care of the routing. So eventually you later can access the app from any valid frontend routes.
*Likewise, the static read only variant (Poetry Viewer) of the app also rely on the service worker for routing. Poetry Viewer is often hosted in a server without explicit backend and you may not have control of the server config for the rewrite rules.

==MacOS Desktop App==
[[File:Local app on MacOS.png|thumb|local app on MacOS]]

==='''Prerequisites'''===
#[https://dotnet.microsoft.com/en-us/download/dotnet/6.0 ASP.NET Core Runtime] for macOS Binaries Arm64 or x64. Optional. If you had installed the self contained release, you don't need to install

==='''Installation'''===
# Extract the Zip file to a desired folder, for example, "/Users/YourUsername/Documents/PoetryApp"
#[https://support.apple.com/en-au/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/2.12/mac/11.0 Apply "chmod 755" to files "StartPoetryApp.sh" and "bin/PoetryApp"] to make both become executable.

===Execution===

=====In Terminal=====
#Under "/Users/YourUsername/Documents/PoetryApp", execute "./StartPoetryApp.sh". And this will launch PoetryApp as a local service hosting http://localhost:5300 and open browser Safari or Chrome, and go to http://localhost:5300

=====In Finder=====

#Double click "StartPoetryApp.sh".

[[File:Mac terminal.png|alt=mac terminal|thumb|mac terminal]]

Main Page

2022-10-27T09:49:43Z

Admin: /* Welcome to {{SITENAME}}! */

== Welcome to {{SITENAME}}! ==
Poetry Management and Publishing (Poetry MP) is a poetry app for a poet to manage poems and publish online.

The full app can run on Microsoft Windows, MacOS and Linux as a desktop app, or run on a Windows based or Linux based Web server as a Web app. And the frontend of the app may be hosted as a static Website to publish the poetry content. Thus, you as a poet can use the full app to manage your poetry on Windows/MacOS/Linux PC, and publish content in a static Website which is cheap or free to run. If you would install the full app in a Web server, the full app can support both management and publishing.

The app is distributed as freeware.

To have some impression of the app, please check:

* [[Live Examples]]
* [[Screenshots]]
* [[User Manual]]

'''Remarks:'''

It is presumed that you are a computer literate who understands basic concept of Website, upload, and Webmastering, though knowledge of Web programming is not required.

=== Background ===
How people have been publishing or sharing poems through electronic means if not involving traditional publishers? Here's the list of some scenarios:

# Copy machine. After writing some poems on papers, the poet made copies and mail out.
# Fax.
# Email since the birth of the Internet.
# BBS.
# Gopher.
# Newsgroup.
# Static Web pages.
# Blog
# Web 2.0 applications such as social networking services and wiki.
# Poetry sites like: <nowiki>https://poets.org/</nowiki> ; <nowiki>https://www.poetryfoundation.org</nowiki> ; <nowiki>https://www.poetrybyheart.org.uk/</nowiki> ; <nowiki>https://thepoetryhour.com/</nowiki>
# Poetry writing apps, like those listed at https://play.google.com/store/search?q=poetry+writing&c=apps

=== Poetry Management and Publishing (PoetryMP) ===
The app is designed for the following users:

# Poets who would write poems on computers and publish online.
# Poetry lovers who would publish poems authorized by the poets, or publish poems which copyright are expired or are in public domain.

And the advanced features are designed for such scenarios:

# The poet had written over 100 poems.
# Many of the poems contain allusions and quotations which need annotations so readers who may not be familiar with the allusions could understand. This app supports numbered annotations (superscript) and phase-based annotations which may be shared among poems.
# Full text search.
# Tagging for categorization.
# Insert images to a poem. The image could be embedded, locally hosted or external. And you may convert external images to locally hosted, so the full app or the static read only variant may work fully offline with images being hosted locally.
# The readers will read, browse and search poems on PC, tablets and smartphones.
# Allocate poems into albums.
# For Chinese poets and respective readers, the Chinese edition of the app provides simplified/traditional Chinese conversion.

What's Not:

* Specialized for writing poems with vocabulary dictionary.
* A forum
* A social networking app

Some poetry apps and Websites have the following features, however PoetryMP does not.

From certain point of view, PoetryMP is a personal poetry blog which can run as a desktop program or a Website. And you can publish your poetry through the full blow Website or a static Website.

=== Distribution and Installation ===
PoetryMP is distributed in 2 forms: Zip and MSI at the '''[[Download]]''' area.

The app is build on ASP.NET Core and can run on Windows, MacOS and Linux with ASP.NET 6 runtime installed.

And the static readonly variant of the app is a [https://en.wikipedia.org/wiki/Single-page_application SPA], which is using the same codes of the frontend of the full app. For more details, please check:

*[[Deployment]]
*[[Deployment for Poetry Viewer]]

Download

2022-10-27T09:23:54Z

Admin:

Download

2022-10-27T09:20:19Z

Admin:

File:CreateZips.zip

2022-10-27T09:07:24Z

Admin:

2022-10-26T10:31:50Z

Admin: /* Distribution and Installation */

== Welcome to {{SITENAME}}! ==
Poetry Management and Publishing (Poetry MP) is a poetry app for a poet to manage poems and publishing online.

The full app can run on Microsoft Windows, MacOS and Linux as a desktop app, or run on a Windows based or Linux based Web server as a Web app. And the frontend of the app may be hosted as a static Website to publish the poetry content. Thus, you as a poet can use the full app to manage your poetry on Windows/MacOS/Linux PC, and publish content in a static Website which is cheap or free to run. If you can install the full app in a Web server, the full app can support both management and publishing.

The app is distributed as freeware.

To have some impression of the app, please check:

* [[Live Examples]]
* [[Screenshots]]
* [[User Manual]]

'''Remarks:'''

It is presumed that you are a computer literate who understand basic concept of Website, upload, and Webmastering, though knowledge of Web programming is not required.

=== Background ===
How people have been publishing or sharing poems through electronic means if not involving traditional publishers? Here's the list of some scenarios:

# Copy machine. After writing some poems on papers, the poet made copies and mail out.
# Fax.
# Email since the birth of the Internet.
# BBS.
# Gopher.
# Newsgroup.
# Static Web pages.
# Blog
# Web 2.0 applications such as social networking services and wiki.
# Poetry sites like: <nowiki>https://poets.org/</nowiki> ; <nowiki>https://www.poetryfoundation.org</nowiki> ; <nowiki>https://www.poetrybyheart.org.uk/</nowiki> ; <nowiki>https://thepoetryhour.com/</nowiki>
# Poetry writing apps, like those listed at https://play.google.com/store/search?q=poetry+writing&c=apps

=== Poetry Management and Publishing (PoetryMP) ===
The app is designed for the following users:

# Poets who would write poems on computers and publish online.
# Poetry lovers who would publish poems authorized by the poets, or publish poems which copyright are expired or are in public domain.

And the advanced features are designed for such scenarios:

# The poet had written over 100 poems.
# Many of the poems contain allusions and quotations which need annotations so readers who may not be familiar with the allusions could understand. This app supports numbered annotations (superscript) and phase-based annotations which may be shared among poems.
# Full text search.
# Tagging for categorization.
# Insert images to a poem. The image could be embedded, locally hosted or external. And you may convert external images to locally hosted, so the full app or the static read only variant may work fully offline with images being hosted locally.
# The readers will read, browse and search poems on PC, tablets and smartphones.
# Allocate poems into albums.
# For Chinese poets and respective readers, the Chinese edition of the app provides simplified/traditional Chinese conversion.

What's Not:

* Specialized for writing poems with vocabulary dictionary.
* A forum
* A social networking app

Some poetry apps and Websites have the following features, however PoetryMP does not.

From certain point of view, PoetryMP is a personal poetry blog which can run as a desktop program or a Website. And you can publish your poetry through the full blow Website or a static Website.

=== Distribution and Installation ===
PoetryMP is distributed in 2 forms: Zip and MSI at the '''[[Download]]''' area.

The app is build on ASP.NET Core and can run on Windows, MacOS and Linux with ASP.NET 6 runtime installed.

And the static readonly variant of the app is a [https://en.wikipedia.org/wiki/Single-page_application SPA], which is using the same codes of the frontend of the full app. For more details, please check:

*[[Deployment]]
*[[Deployment for Poetry Viewer]]