anas/divan
1
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects Releases Wiki Activity

documentations

Browse Source
This commit is contained in:
Hamid Reza Mohammadi 2026-08-14 19:41:04 +03:30
parent 1d67041247
commit a027c08e28
1 changed files with 12 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
RUNNING_LOCALLY.md
View File

@ -119,10 +119,12 @@ Since the database is brand new and empty, you'll be redirected — first to a l
This is expected, not an error — an empty database has no poets yet, so there's nothing to show This is expected, not an error — an empty database has no poets yet, so there's nothing to show
on the home page, and Ganjoor routes you here instead of showing a broken page. on the home page, and Ganjoor routes you here instead of showing a broken page.
## 6. Create your admin account ## 6. Log in as admin
If you don't already have an account, go to `/signup` and register using the email address You don't need a separate signup step for the very first account. `RSecurityBackend` (the
configured as `RSecurityBackend:FirstUserEmail` in `RMuseum/appsettings.json` — by default: library `RMuseum` uses for user management) creates the first user automatically the first time
you log in with the email address configured as `RSecurityBackend:FirstUserEmail` in
`RMuseum/appsettings.json` — by default:
```json ```json
"RSecurityBackend": { "RSecurityBackend": {
@ -130,9 +132,9 @@ configured as `RSecurityBackend:FirstUserEmail` in `RMuseum/appsettings.json`
} }
``` ```
The very first account created with that exact email address automatically becomes the site's Just go to `/login` and enter that email with any password meeting the site's password
admin. (You can use a different email if you'd rather — just update `FirstUserEmail` to match requirements — that first login creates the account and makes it the site's admin. (You can use a
before signing up.) different email if you'd rather — just update `FirstUserEmail` to match before your first login.)
## 7. Import real content ## 7. Import real content
@ -152,8 +154,10 @@ specific poet's numeric id to import just that one for quicker local testing. Po
`2`, not `1`. `2`, not `1`.
Click **شروع درون‌ریزی** ("start import"). The job runs in the background — track its progress on Click **شروع درون‌ریزی** ("start import"). The job runs in the background — track its progress on
the **Admin → کارها** (Jobs) page. Once it finishes, refresh the home page: your local Ganjoor now the **Admin → کارها** (Jobs) page. It also regenerates the century groupings the home page needs
has real poets, poems, and categories in it. right after importing (the same thing the "بازسازی گروه‌بندی بر اساس قرن" button on the Poets admin
page does) — you don't need to run that separately. Once the job finishes, refresh the home page:
your local Ganjoor now has real poets, poems, and categories in it.
Re-running the import later (e.g. to pick up a poet you skipped the first time) is always safe — Re-running the import later (e.g. to pick up a poet you skipped the first time) is always safe —
it only adds what's missing, and never duplicates or overwrites content already in your database. it only adds what's missing, and never duplicates or overwrites content already in your database.