Modern web uygulamalar\u0131nda i\u00e7erik y\u00f6netimi, kullan\u0131c\u0131 dostu aray\u00fczler ve esnek depolama \u00e7\u00f6z\u00fcmleri b\u00fcy\u00fck \u00f6nem ta\u015f\u0131r. Bu makalede, Python ekosisteminin g\u00fc\u00e7l\u00fc ara\u00e7lar\u0131n\u0131 bir araya getirerek dinamik ve y\u00f6netilebilir web i\u00e7erikleri olu\u015fturmay\u0131 inceleyece\u011fiz: Hafif ve esnek web \u00e7at\u0131s\u0131 Flask, metin bi\u00e7imlendirme i\u00e7in pop\u00fcler Markdown s\u00f6zdizimini HTML’e \u00e7eviren Python-Markdown k\u00fct\u00fcphanesi ve sunucusuz, basit bir veritaban\u0131 \u00e7\u00f6z\u00fcm\u00fc olan SQLite. Bu \u00fc\u00e7l\u00fcy\u00fc entegre ederek, kullan\u0131c\u0131lar\u0131n Markdown format\u0131nda i\u00e7erik girmesine, bu i\u00e7eri\u011fin veritaban\u0131nda saklanmas\u0131na ve web sayfas\u0131nda HTML olarak g\u00f6r\u00fcnt\u00fclenmesine olanak tan\u0131yan bir web uygulamas\u0131 geli\u015ftirece\u011fiz. Bu yakla\u015f\u0131m, bloglar, dok\u00fcmantasyon siteleri veya basit i\u00e7erik y\u00f6netim sistemleri (CMS) i\u00e7in ideal bir temel sunar.<\/p>\n
Flask, mikro-\u00e7er\u00e7eve yap\u0131s\u0131yla h\u0131zl\u0131 prototipleme ve k\u00fc\u00e7\u00fck\/orta \u00f6l\u00e7ekli uygulamalar i\u00e7in m\u00fckemmel bir se\u00e7imdir. Markdown, teknik yazarlar ve i\u00e7erik olu\u015fturucular aras\u0131nda yayg\u0131n olarak kullan\u0131lan, okunmas\u0131 ve yazmas\u0131 kolay bir bi\u00e7imlendirme dilidir. Python-Markdown, bu Markdown i\u00e7eri\u011fini programatik olarak web taray\u0131c\u0131lar\u0131n\u0131n anlayabilece\u011fi HTML’e d\u00f6n\u00fc\u015ft\u00fcr\u00fcr. SQLite ise, ayr\u0131 bir veritaban\u0131 sunucusu gerektirmeyen, dosya tabanl\u0131 bir veritaban\u0131 motoru olup, geli\u015ftirme a\u015famas\u0131nda ve k\u00fc\u00e7\u00fck \u00f6l\u00e7ekli uygulamalarda kolayca kullan\u0131labilir. Bu makale boyunca, bu teknolojileri ad\u0131m ad\u0131m nas\u0131l bir araya getirece\u011fimizi, temel bir i\u00e7erik ekleme, listeleme ve g\u00f6r\u00fcnt\u00fcleme uygulamas\u0131n\u0131 nas\u0131l geli\u015ftirece\u011fimizi detayl\u0131 bir \u015fekilde a\u00e7\u0131klayaca\u011f\u0131z.<\/p>\n
Herhangi bir Python projesine ba\u015flamadan \u00f6nce, ba\u011f\u0131ml\u0131l\u0131k \u00e7ak\u0131\u015fmalar\u0131n\u0131 \u00f6nlemek ve projenin temiz kalmas\u0131n\u0131 sa\u011flamak i\u00e7in sanal bir ortam olu\u015fturmak iyi bir uygulamad\u0131r.<\/p>\n
\u00d6ncelikle projemiz i\u00e7in bir dizin olu\u015ftural\u0131m ve bu dizine ge\u00e7elim:<\/p>\n
mkdir flask_markdown_app\ncd flask_markdown_app<\/code><\/pre>\n\u015eimdi, bir sanal ortam olu\u015ftural\u0131m ve onu etkinle\u015ftirelim:<\/p>\n
python3 -m venv venv\nLinux\/macOS<\/h2>\nsource venv\/bin\/activate\nWindows<\/h2>\nvenv\\Scripts\\activate<\/code><\/pre>\n
Sanal ortam etkinle\u015ftirildikten sonra, gerekli Python k\u00fct\u00fcphanelerini y\u00fckleyebiliriz. Bu projemiz i\u00e7in Flask, Python-Markdown ve veritaban\u0131 etkile\u015fimi i\u00e7in Flask-SQLAlchemy k\u00fct\u00fcphanelerine ihtiyac\u0131m\u0131z olacak:<\/p>\n
pip install Flask Flask-SQLAlchemy Markdown<\/code><\/pre>\nBu komutlar, Flask web \u00e7at\u0131s\u0131n\u0131, SQLAlchemy’nin Flask entegrasyonunu ve Markdown metinlerini HTML’e \u00e7evirecek olan Python-Markdown k\u00fct\u00fcphanesini sanal ortam\u0131n\u0131za kuracakt\u0131r.<\/p>\n
Temel Flask Uygulamas\u0131 Olu\u015fturma<\/h3>\n
\u015eimdi, projemizin iskeletini olu\u015fturarak Flask uygulamas\u0131n\u0131 ba\u015flatal\u0131m. app.py<\/code> ad\u0131nda bir dosya olu\u015ftural\u0131m ve i\u00e7ine temel Flask uygulamas\u0131n\u0131 yazal\u0131m:<\/p>\n# app.py\nfrom flask import Flask, render_template, request, redirect, url_for\nfrom flask_sqlalchemy import SQLAlchemy\nimport markdown\nfrom markupsafe import Markup\nimport datetime\n\napp = Flask(__name__)\napp.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:\/\/\/site.db'\napp.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False\ndb = SQLAlchemy(app)\n\nVeritaban\u0131 modeli burada tan\u0131mlanacak<\/h2>\n\nAna sayfa ve di\u011fer rotalar burada tan\u0131mlanacak<\/h2>\n\nif __name__ == '__main__':\n with app.app_context():\n db.create_all() # Uygulama ba\u015flat\u0131ld\u0131\u011f\u0131nda veritaban\u0131 tablolar\u0131n\u0131 olu\u015ftur\n app.run(debug=True)<\/code><\/pre>\n
Bu kod par\u00e7ac\u0131\u011f\u0131, Flask uygulamas\u0131n\u0131 ba\u015flat\u0131r, SQLite veritaban\u0131n\u0131n yolunu yap\u0131land\u0131r\u0131r ve Flask-SQLAlchemy objesini olu\u015fturur. debug=True<\/code> ayar\u0131, geli\u015ftirme a\u015famas\u0131nda hatalar\u0131n ayr\u0131nt\u0131l\u0131 bir \u015fekilde g\u00f6sterilmesini ve kodda yap\u0131lan de\u011fi\u015fikliklerin otomatik olarak alg\u0131lan\u0131p uygulaman\u0131n yeniden y\u00fcklenmesini sa\u011flar. db.create_all()<\/code> komutu, tan\u0131mlad\u0131\u011f\u0131m\u0131z veritaban\u0131 modellerine g\u00f6re tablolar\u0131 olu\u015fturur. Bu komutun app.app_context()<\/code> i\u00e7inde \u00e7al\u0131\u015ft\u0131r\u0131lmas\u0131 \u00f6nemlidir, \u00e7\u00fcnk\u00fc veritaban\u0131 i\u015flemleri bir uygulama ba\u011flam\u0131 gerektirir.<\/p>\nVeritaban\u0131 Yap\u0131s\u0131 ve Modeli<\/h3>\n
\u0130\u00e7eriklerimizi saklamak i\u00e7in bir veritaban\u0131 tablosuna ihtiyac\u0131m\u0131z var. Flask-SQLAlchemy kullanarak bu tabloyu bir Python s\u0131n\u0131f\u0131 olarak tan\u0131mlayaca\u011f\u0131z. Bu s\u0131n\u0131f, her bir i\u00e7eri\u011fin (\u00f6rne\u011fin bir blog yaz\u0131s\u0131) hangi \u00f6zelliklere sahip olaca\u011f\u0131n\u0131 belirler.<\/p>\n
Content<\/code> Modeli Tan\u0131mlama<\/h4>\napp.py<\/code> dosyam\u0131zda, db = SQLAlchemy(app)<\/code> sat\u0131r\u0131n\u0131n alt\u0131na a\u015fa\u011f\u0131daki Content<\/code> modelini ekleyelim:<\/p>\n# app.py (devam\u0131)\n\nclass Content(db.Model):\n id = db.Column(db.Integer, primary_key=True)\n title = db.Column(db.String(100), nullable=False)\n markdown_content = db.Column(db.Text, nullable=False)\n html_content = db.Column(db.Text, nullable=False)\n created_at = db.Column(db.DateTime, default=datetime.datetime.now)\n\n def __repr__(self):\n return f\"Content('{self.title}', '{self.created_at}')\"<\/code><\/pre>\nBu Content<\/code> modeli \u015fu s\u00fctunlara sahiptir:
\n* id<\/code>: Her i\u00e7eri\u011fin benzersiz kimli\u011fi (otomatik artan birincil anahtar).
\n* title<\/code>: \u0130\u00e7eri\u011fin ba\u015fl\u0131\u011f\u0131 (en fazla 100 karakter, bo\u015f b\u0131rak\u0131lamaz).
\n* markdown_content<\/code>: Kullan\u0131c\u0131n\u0131n girdi\u011fi orijinal Markdown metni (bo\u015f b\u0131rak\u0131lamaz).
\n* html_content<\/code>: markdown_content<\/code>‘in Python-Markdown ile d\u00f6n\u00fc\u015ft\u00fcr\u00fclm\u00fc\u015f HTML versiyonu (bo\u015f b\u0131rak\u0131lamaz). Bu, her seferinde d\u00f6n\u00fc\u015ft\u00fcrme yapma ihtiyac\u0131n\u0131 ortadan kald\u0131rarak performans\u0131 art\u0131r\u0131r.
\n* created_at<\/code>: \u0130\u00e7eri\u011fin olu\u015fturulma zaman\u0131 (varsay\u0131lan olarak ge\u00e7erli zaman).<\/p>\n__repr__<\/code> metodu, bir Content<\/code> objesi yazd\u0131r\u0131ld\u0131\u011f\u0131nda daha anlaml\u0131 bir \u00e7\u0131kt\u0131 vermesini sa\u011flar.<\/p>\n\u0130\u00e7erik Ekleme Aray\u00fcz\u00fc<\/h3>\n
Kullan\u0131c\u0131lar\u0131n Markdown i\u00e7eri\u011fi girmesi i\u00e7in bir form ve bu formu i\u015fleyecek bir Flask rotas\u0131 olu\u015fturmam\u0131z gerekiyor.<\/p>\n
\u0130\u00e7erik Ekleme Rotas\u0131 ve Formu<\/h4>\n
app.py<\/code> dosyam\u0131za add_content<\/code> ad\u0131nda bir rota ekleyelim:<\/p>\n# app.py (devam\u0131)\n\n@app.route('\/add', methods=['GET', 'POST'])\ndef add_content():\n if request.method == 'POST':\n title = request.form['title']\n markdown_text = request.form['markdown_content']\n \n # Markdown'\u0131 HTML'e \u00e7evir\n html_text = markdown.markdown(markdown_text, extensions=['fenced_code', 'tables'])\n \n # Yeni i\u00e7erik objesini olu\u015ftur\n new_content = Content(title=title, markdown_content=markdown_text, html_content=html_text)\n \n # Veritaban\u0131na ekle ve kaydet\n db.session.add(new_content)\n db.session.commit()\n \n return redirect(url_for('index')) # Ana sayfaya y\u00f6nlendir\n \n return render_template('add_content.html')<\/code><\/pre>\nBu rota, GET<\/code> iste\u011fi geldi\u011finde add_content.html<\/code> \u015fablonunu render eder. POST<\/code> iste\u011fi geldi\u011finde ise formdan gelen title<\/code> ve markdown_content<\/code> verilerini al\u0131r. markdown.markdown()<\/code> fonksiyonu ile Markdown metnini HTML’e \u00e7eviririz. Burada extensions=['fenced_code', 'tables']<\/code> gibi uzant\u0131lar kullanarak kod bloklar\u0131n\u0131 ve tablolar\u0131 destekleyebiliriz. Daha sonra, yeni bir Content<\/code> objesi olu\u015fturulur, veritaban\u0131na eklenir ve kaydedilir. Son olarak, kullan\u0131c\u0131 ana sayfaya y\u00f6nlendirilir.<\/p>\nadd_content.html<\/code> \u015eablonu<\/h4>\ntemplates<\/code> ad\u0131nda bir klas\u00f6r olu\u015ftural\u0131m ve i\u00e7ine add_content.html<\/code> dosyas\u0131n\u0131 ekleyelim:<\/p>\n\n{% extends \"base.html\" %}\n\n{% block title %}\u0130\u00e7erik Ekle{% endblock %}\n\n{% block content %}\n \n \n