From 7283791439102b0d032c033eed018efa590f7cd0 Mon Sep 17 00:00:00 2001 From: saikumarvasa100-hash Date: Fri, 7 Nov 2025 17:01:59 +0530 Subject: [PATCH] Add Ghost/Blogosfera self-hosted documentation in Telugu (Fixes #73) This PR adds comprehensive Telugu documentation for the Ghost-based Blogosfera blogging platform. Includes: - Complete installation guide in Telugu - Ghost CLI commands and usage - Directory structure explanation - Theme customization instructions - Content management guide - Demo video URL: https://drive.google.com/file/d/1VJQXOGa-WUJ3GM_0OkJDJ7e2IkXYTUEf/view?usp=sharing - LinkedIn post: https://www.linkedin.com/posts/d-karthiksai-834ba62a9_blogosfera-ghost-opensource-activity-7392521241154404352-4nCq Team Members: Vasa Saikumar, Damma Karthik Sai Fixes #73 --- selfhosted/saikumar-blogosfera.md | 203 ++++++++++++++++++++++++++++++ 1 file changed, 203 insertions(+) create mode 100644 selfhosted/saikumar-blogosfera.md diff --git a/selfhosted/saikumar-blogosfera.md b/selfhosted/saikumar-blogosfera.md new file mode 100644 index 0000000..45122ca --- /dev/null +++ b/selfhosted/saikumar-blogosfera.md @@ -0,0 +1,203 @@ +# Blogosfera - Ideas, Grow, Connect + +## ప్రాజెక్ట్ గురించి +**ప్రాజెక్ట్ పేరు:** Blogosfera +**స్లోగన్:** Ideas, Grow, Connect +**సృష్టికర్త:** Karthik + +Blogosfera అనేది Ghost ఆధారితంగా రూపొందించబడిన ఒక స్థానిక బ్లాగింగ్ ప్లాట్‌ఫారమ్. ఇది వినియోగదారులకు వారి ఆలోచనలను భాగస్వామ్యం చేయడానికి, అభివృద్ధి చెందడానికి మరియు ఇతరులతో అనుసంధానం కావడానికి ఒక సులభమైన మార్గాన్ని అందిస్తుంది. + +## Ghost గురించి +Ghost అనేది Node.js ఆధారితంగా రూపొందించబడిన ఒక headless CMS (Content Management System). ఇది ప్రత్యేకంగా బ్లాగింగ్ మరియు కంటెంట్ పబ్లిషింగ్ కోసం రూపొందించబడింది. + +### ముఖ్య సాంకేతిక లక్షణాలు: +- **Backend:** Node.js +- **Database:** SQLite +- **Frontend:** Handlebars, HTML, CSS, JavaScript +- **Server:** Localhost Server + +## సిస్టమ్ అవసరాలు +Ghost ను ఇన్‌స్టాల్ చేయడానికి క్రింది వాటి అవసరం: +- Node.js (వెర్షన్ 16 లేదా అంతకంటే ఎక్కువ) +- npm (Node Package Manager) +- 1 GB RAM (కనీసం) +- 5 GB disk space + +## ఇన్‌స్టలేషన్ దశలు + +### 1. Ghost CLI ఇన్‌స్టాల్ చేయడం +```bash +npm install -g ghost-cli +``` + +### 2. ప్రాజెక్ట్ డైరెక్టరీ సృష్టించడం +```bash +mkdir blogosfera +cd blogosfera +``` + +### 3. Ghost ఇన్‌స్టాల్ చేయడం +```bash +ghost install local +``` + +## అనువర్తన లక్షణాలు + +### URL లు +- **మెయిన్ సైట్:** http://localhost:2368 +- **అడ్మిన్ పానెల్:** http://localhost:2368/ghost + +### Ghost CLI కమాండ్లు +క్రింది కమాండ్లను ఉపయోగించి Ghost ను నియంత్రించవచ్చు: + +```bash +ghost start # Ghost ను ప్రారంభించడం +ghost stop # Ghost ను ఆపడం +ghost restart # Ghost ను పునఃప్రారంభించడం +ghost log # లాగ్స్ చూడటం +ghost doctor # సమస్యలను తనిఖీ చేయడం +``` + +## డైరెక్టరీ స్ట్రక్చర్ + +### 1. Content డైరెక్టరీ +``` +content/ +├── data/ +│ └── ghost-local.db # Database ఫైల్ +├── images/ # అప్‌లోడ్ చేసిన చిత్రాలు +└── themes/ # థీమ్‌లు +``` + +### 2. Database +- **Location:** content/data/ghost-local.db +- **Type:** SQLite +- ఇది అన్ని పోస్ట్‌లు, వినియోగదారులు మరియు సెట్టింగ్‌లను నిల్వ చేస్తుంది + +### 3. Images +- **Location:** content/images/ +- బ్లాగ్ పోస్ట్‌లకు అప్‌లోడ్ చేసిన అన్ని చిత్రాలు ఇక్కడ నిల్వ చేయబడతాయి + +### 4. Themes +- **Location:** content/themes/ +- Ghost థీమ్‌లు ఇక్కడ నిల్వ చేయబడతాయి +- డిఫాల్ట్ థీమ్: Casper + +## థీమ్ కస్టమైజేషన్ + +Ghost థీమ్‌లు Handlebars టెంప్లేట్ ఇంజిన్ ఉపయోగించి రూపొందించబడతాయి. + +### ముఖ్య థీమ్ ఫైళ్లు: +1. **default.hbs** - మెయిన్ లేఅవుట్ ఫైల్ +2. **index.hbs** - హోమ్ పేజీ టెంప్లేట్ +3. **post.hbs** - వ్యక్తిగత పోస్ట్ టెంప్లేట్ + +### థీమ్ మార్పులు చేయడం: +1. `content/themes/` లో మీ థీమ్ ఫైళ్లను ఎడిట్ చేయండి +2. మార్పులు సేవ్ చేయండి +3. Ghost ను పునఃప్రారంభించండి: +```bash +ghost restart +``` + +## కంటెంట్ నిర్వహణ + +### పోస్ట్ సృష్టించడం: +1. http://localhost:2368/ghost కు వెళ్లండి +2. "New Post" క్లిక్ చేయండి +3. మీ కంటెంట్ రాయండి +4. "Publish" క్లిక్ చేయండి + +### కంటెంట్ బ్యాకప్: +Ghost అడ్మిన్ పానెల్ నుండి మీ కంటెంట్‌ను export చేయవచ్చు: +1. Settings → Advanced → Export +2. JSON ఫార్మాట్‌లో డేటా డౌన్‌లోడ్ అవుతుంది + +## ప్రయోజనాలు + +### 1. స్వీయ-హోస్ట్ చేయబడినది +- మీ డేటాపై పూర్తి నియంత్రణ +- గోప్యత మరియు భద్రత +- మూడవ పక్షం సేవలపై ఆధారపడకుండా + +### 2. తేలికపాటి మరియు వేగవంతమైనది +- Node.js ఆధారితంగా నిర్మించబడింది +- SQLite డేటాబేస్ తక్కువ వనరులను వాడుకుంటుంది +- వేగవంతమైన లోడింగ్ సమయాలు + +### 3. అనుకూలీకరణ సామర్థ్యం +- థీమ్‌లను సులభంగా కస్టమైజ్ చేయవచ్చు +- Handlebars టెంప్లేట్‌లు ఉపయోగించి +- HTML, CSS, JavaScript మద్దతు + +### 4. సులభమైన నిర్వహణ +- Ghost CLI ద్వారా సులభ నిర్వహణ +- వినియోగదారు-స్నేహపూర్వక అడ్మిన్ ఇంటర్‌ఫేస్ +- నిబంధనల తనిఖీ (ghost doctor) + +## డెమో వీడియో +ప్రాజెక్ట్ యొక్క విశేషణాలను అన్వేషించడానికి డెమో వీడియో: +**వీడియో URL:** https://drive.google.com/file/d/1VJQXOGa-WUJ3GM_0OkJDJ7e2IkXYTUEf/view?usp=sharing + +## LinkedIn పోస్ట్ +**పోస్ట్ URL:** https://www.linkedin.com/posts/d-karthiksai-834ba62a9_blogosfera-ghost-opensource-activity-7392521241154404352-4nCq?utm_source=social_share_send&utm_medium=android_app + +## టీమ్ సభ్యులు +- **Vasa Saikumar** +- **Damma Karthik Sai** + +## సాంకేతిక వివరాలు + +### అభివృద్ధి స్టాక్: +- **Backend Framework:** Ghost (Node.js) +- **Database:** SQLite +- **Template Engine:** Handlebars +- **Frontend:** HTML5, CSS3, JavaScript +- **Package Manager:** npm + +### ముఖ్య ఫీచర్లు: +1. రిచ్ టెక్స్ట్ ఎడిటర్ +2. మార్క్‌డౌన్ మద్దతు +3. SEO ఆప్టిమైజేషన్ +4. రెస్పాన్సివ్ డిజైన్ +5. కంటెంట్ షెడ్యూలింగ్ +6. థీమ్ కస్టమైజేషన్ +7. డేటా ఎక్స్‌పోర్ట్/ఇంపోర్ట్ + +## ట్రబుల్షూటింగ్ + +### సాధారణ సమస్యలు మరియు పరిష్కారాలు: + +1. **Ghost ప్రారంభం కావడం లేదు:** +```bash +ghost doctor +ghost stop +ghost start +``` + +2. **పోర్ట్ ఇప్పటికే ఉపయోగంలో ఉంది:** +```bash +# పోర్ట్ 2368 ను ఉపయోగిస్తున్న ప్రాసెస్ను కనుగొనండి +lsof -i :2368 +# లేదా పోర్ట్ మార్చండి config.production.json లో +``` + +3. **డేటాబేస్ లోపాలు:** +```bash +ghost doctor +# డేటాబేస్ బ్యాకప్ తీసుకోండి +cp content/data/ghost-local.db content/data/ghost-local.db.backup +``` + +## భవిష్యత్తు మెరుగుదలలు +- వినియోగదారు ప్రమాణీకరణ వ్యవస్థ +- మల్టీ-ఆథర్ మద్దతు +- కామెంట్ సిస్టమ్ +- సోషల్ మీడియా ఇంటిగ్రేషన్ +- న్యూస్‌లెటర్ ఫంక్షనాలిటీ + +## ముగింపు +Blogosfera అనేది Ghost ఆధారిత స్వీయ-హోస్ట్ చేయబడిన బ్లాగింగ్ ప్లాట్‌ఫారమ్, ఇది వినియోగదారులకు వారి ఆలోచనలను భాగస్వామ్యం చేయడానికి మరియు అభివృద్ధి చెందడానికి ఒక శక్తివంతమైన సాధనాన్ని అందిస్తుంది. దీని సులభ ఇన్‌స్టలేషన్, వేగవంతమైన పనితీరు మరియు అనుకూలీకరణ సామర్థ్యం దీనిని ఒక అద్భుతమైన ఎంపికగా చేస్తుంది. + +--- +**గమనిక:** ఈ ప్రాజెక్ట్ స్థానిక అభివృద్ధి ప్రయోజనాల కోసం రూపొందించబడింది. ప్రొడక్షన్ వాతావరణంలో ఉపయోగించడానికి అదనపు భద్రతా చర్యలు అవసరం.