Leser wie Sie helfen, MUO zu unterstützen. Wenn Sie über Links auf unserer Website einen Kauf tätigen, erhalten wir möglicherweise eine Affiliate-Provision.

Open-Source-Projekte werden zunehmend nachgefragt, und es gibt eine riesige Anzahl, in die Sie sich verbeißen können. Um mit der Arbeit an einem Open-Source-Projekt zu beginnen, ist es hilfreich, wenn Sie den Quellcode einfach klonen und das Projekt lokal einrichten können.

Obwohl das Klonen einfach erscheinen mag, kann es bei Projekten, die mit Django erstellt wurden, eine Herausforderung darstellen. Django hat viele Abhängigkeiten und Pakete, die Konflikte verursachen, wenn sie nicht installiert sind.

Sie müssen die Konflikte beheben, bevor das Projekt auf Ihrem lokalen Computer ausgeführt werden kann. Nun, du musst nicht mehr leiden.

In den nächsten Schritten erfahren Sie, wie Sie Ihr Django-Projekt mit minimalen Konflikten klonen, einrichten und ausführen.

Was wirst du brauchen

Um dieses Handbuch optimal nutzen zu können, sollten Sie über Folgendes verfügen:

instagram viewer
  • Python (Python3 und höher)
  • Arbeitskenntnisse der Python-Django-Bibliothek
  • Pip3
  • Vertrautheit mit virtuellen Python-Umgebungen
  • Grundkenntnisse von Git und GitHub
  • Ein GitHub-Konto
  • Git auf Ihrem lokalen Computer installiert
  • Vertrautheit mit der Kommandozeile

Wenn diese Anforderungen erfüllt sind, können Sie ein Projekt klonen.

1. Klonen Sie das Projekt von GitHub

Sie können ein Beispielprojekt aus klonen GitHub und konfigurieren Sie es auf Ihrem lokalen Computer.

Um das Projekt zu klonen, klicken Sie auf die grüne Schaltfläche mit der Bezeichnung Code. Wählen Sie in der Dropdown-Liste entweder HTTP- oder SSH-Links aus und kopieren Sie sie. Diese Links sind die GitHub-URLs für das Projekt. Jeder von ihnen wird es tun.

Wenn du willst Mit Git zu einem Open-Source-Projekt beitragen, müssen Sie zuerst Gabel das Projekt aus dem Repository des Projekts, um vor dem Klonen eine Kopie zu erstellen.

Zurück zu Ihrem Computer, richten Sie einen Ordner mit dem Namen ein Klon_Boma. Denken Sie daran, mit dem in den Ordner zu navigieren cd clone_boma Befehl.

Führen Sie als Nächstes den folgenden Befehl aus, um das Projekt in den Ordner zu klonen.

git-Klon <Repository-URL>

Um also das Beispielprojekt über HTTP zu klonen, verwenden Sie diesen Befehl:

git Klon https://github.com/Dindihub/Boma-watch.git

2. Überprüfen Sie die Projektdateien

Nach dem Klonen Verwenden Sie den Befehl ls um zu überprüfen, ob die Dateien aus dem Boma-Watch-Projekt vorhanden sind. Typ ls um den gesamten Inhalt des Ordners aufzulisten.

Sie können einen Texteditor Ihrer Wahl verwenden, um den Inhalt jeder Datei zu überprüfen oder sie auf der GitHub-Website anzuzeigen.

3. Richten Sie eine virtuelle Umgebung ein

Sie müssen eine virtuelle Umgebung für das Projekt einrichten. Das Beispielprojekt enthält eine Pipenv-Umgebung, die die Abhängigkeiten des Projekts in zwei Dateien angibt: Pipfile Und Pipfile.lock.

Dieser Fehler tritt auf, wenn Sie das Projekt mit dem alten Pipfile ausführen:

ModuleNotFoundError: Kein Modul namens „distutils.core“

Sie müssen die virtuelle Umgebung löschen und neu installieren. Um die virtuelle Umgebung und ihre Abhängigkeiten zu löschen, führen Sie die folgenden Befehle nacheinander aus.

So entfernen Sie die alte Umgebung:

pipenv --rm

So entfernen Sie beide Pipfiles:

rm Pipfile*

So installieren Sie Ihre Pipenv-Abhängigkeiten auf Ihrer Python-Version:

pipenv Installieren--python 3.10

Führen Sie als Nächstes den folgenden Befehl aus, um alle Pipfiles-Pakete zu installieren:

pipenv Installieren Anfragen

Aktivieren Sie dann die virtuelle Umgebung:

pipenv-Shell

Sie sehen die aktivierte virtuelle Umgebung auf der rechten Seite Ihres Terminalfensters.

Wenn Sie Venv zum Erstellen Ihrer virtuellen Umgebung verwenden, führen Sie Folgendes aus, um Abhängigkeiten zu installieren:

PipInstallieren-RAnforderungen.txt

So listen Sie alle installierten Abhängigkeiten auf:

Pip einfrieren > Anforderungen.txt

4. Erstellen Sie eine Datenbank

Sie müssen eine Datenbank installieren, um die Projektdaten zu verwalten. Sie können jede Art von Datenbank auswählen, die Ihren Anforderungen entspricht. Für das Beispielprojekt sollten Sie PostgresSQL verwenden.

Lernen wie man Installieren Sie PostgreSQL unter Ubuntu oder Installieren Sie PostgreSQL unter Windows.

Sobald alles eingestellt ist, starten Sie die Postgres-Shell mit den folgenden Befehlen:

sudo -i -u postgres
psql

Erstellen Sie dann eine Datenbank mit dem Namen neu_boma auf dem Server:

postgres=# Datenbank erstellen new_boma;

Der Server gibt das Wort CREATE DATABASE zurück, wenn er eine Datenbank erstellt. Bestätigen Sie, dass die Datenbank vorhanden ist, indem Sie mit dem Befehl alle Datenbanken im System auflisten l:

In settings.py, müssen Sie die Datenbank mit der Anwendung verbinden. Ersetzen Sie dazu den Datenbankbenutzer, den Namen und das Passwort durch Ihre eigenen lokalen Werte:

#...
DATENBANKEN = {
'Standard': {
'MOTOR':'django.db.backends.postgresql',
'NAME':'neu_boma',
'BENUTZER':'postgr',
'PASSWORT':'Passwort',
 }
}

Denken Sie auch daran, sich zu ändern ZEITZONE in der Datei settings.py entsprechend Ihrem Standort. Dadurch wird Ihre App auf dem neuesten Stand gehalten.

Stellen Sie sicher, dass Sie installiert haben Psycopg2 um alle verfügbaren Bilder aufzunehmen:

$ pipenv Installieren psychopg2

5. Generieren Sie einen geheimen Schlüssel

Jedes Django-Projekt hat eine einzigartige geheimer Schlüssel. Normalerweise wird der geheime Schlüssel online nicht offengelegt. Es sollte in einem sein env Datei, in die Sie einfügen sollten eine .gitignore-Datei aus dem Depot auszuschließen.

Sie müssen eine neue erstellen, damit Ihr Projekt ausgeführt werden kann. Erstellen Sie einen neuen geheimen Schlüssel mit einem Generator für geheime Schlüssel, z Djecrety.

# SICHERHEITSHINWEIS: Halten Sie den in der Produktion verwendeten geheimen Schlüssel geheim!
SECRET_KEY = 'geheimer-schlüssel-kommt-hier'

6. Projekt in die Datenbank migrieren

Führen Sie den folgenden Befehl aus, um Tabellen für die App in der neuen Datenbank zu erstellen:

Pythonverwalten.pyMigrationenApp

Führen Sie dann zum Migrieren Folgendes aus:

Pythonverwalten.pyWandern

Beim Ausführen der python manage.py migrieren Befehl, treten Fehler auf. Die Fehler benachrichtigen Sie über fehlende Module. Stellen Sie sicher, dass Sie alle Module installieren, bevor Sie migrieren.

Wenn Sie alle Abhängigkeiten installiert haben, führen Sie die Migration aus. Wenn die Migrationen abgeschlossen sind, ist es an der Zeit, das Projekt auszuführen.

Wenn Sie alle Abhängigkeiten installiert haben, führen Sie die Migration aus. Wenn die Migrationen ausgeführt werden, ist es an der Zeit, das Projekt auszuführen.

7. Führen Sie das Projekt aus

Führen Sie das Projekt aus, um sicherzustellen, dass alles in Ordnung ist, bevor Sie Ihren Beitrag hinzufügen. Führen Sie die Anwendung mit dem folgenden Befehl aus:

Pythonverwalten.pyLaufserver

Wenn keine Fehler vorhanden sind, öffnen http://127.0.0.1:8000/ in einem Webbrowser. Sie sehen die Zielseite des Projekts wie unten gezeigt:

Das Geheimnis zum Klonen eines Django-Projekts

Das Klonen von Django-Projekten hilft, Ihre Zeit zu optimieren. Sie können sich auf die Entwicklung neuer Funktionen konzentrieren, anstatt ein Projekt von Grund auf neu zu starten.

Das Geheimnis beim Klonen und Ausführen eines Django-Projekts auf einem lokalen Computer besteht darin, zu wissen, wie man mit den Abhängigkeiten umgeht. Stellen Sie nach dem Klonen sicher, dass Sie eine neue virtuelle Umgebung erstellen, Abhängigkeiten installieren und eine Verbindung zu einem zuverlässigen Datenbanksystem herstellen.

Django ist eine leistungsstarke Python-Bibliothek. Erfahren Sie, wie Sie seine Projekte klonen und verwenden, um erstaunliche Anwendungen zu erstellen, die sich auf die Tech-Community auswirken.