Skip to content

Commit 0ebd70c

Browse files
committed
the readme are updated
1 parent cb55964 commit 0ebd70c

File tree

3 files changed

+173
-173
lines changed

3 files changed

+173
-173
lines changed

docs/README.de.md

Lines changed: 70 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -5,144 +5,144 @@
55
- 🇪🇸 [Spanisch](README.es.md)
66
- 🇺🇸 [Englisch](README.md)
77

8-
## Erlernte Kenntnisse
8+
## Behandelte Themen
99

1010
- Grundlegende Funktionsweise eines Browsers.
1111
- Browser Object Model (BOM):
1212
- Navigation
1313
- Location
1414
- Window
1515
- Document Object Model (DOM), seine Knoten und Elemente.
16-
- Knoten auswählen.
16+
- Auswahl von Knoten.
1717
- Erstellen und Entfernen von DOM-Elementen.
18-
- Manipulation von DOM-Attributen sowie deren Stilen und CSS-Klassen.
19-
- DOM-Ereignisbehandlung.
20-
- Standardverhalten in HTML-Komponenten.
21-
- Event Bubbling & Capturing.
22-
- Promises und deren Zustände: *pending*, *fulfilled* und *rejected*.
18+
- Bearbeiten von DOM-Attributen sowie deren Styles und CSS-Klassen.
19+
- Umgang mit DOM-Ereignissen.
20+
- Standardverhalten von HTML-Komponenten.
21+
- *Event Bubbling* und *Capturing*.
22+
- Promises und ihre Zustände: *pending*, *fulfilled* und *rejected*.
2323
- HTTP-Anfragen mit `fetch`.
2424
- `localStorage` und `sessionStorage`.
2525
- Lokale Datenspeicherung in HTML5: Cookies, Storage und IndexedDB.
2626

2727
## Projektbeschreibung
2828

29-
Um das in den virtuellen Kursen erlernte Wissen zu üben und zu demonstrieren, besteht dieses Projekt darin, eine Webanwendung zu entwickeln, die Wallapop ähnlich ist. Die Verwendung von JavaScript-Bibliotheken oder -Frameworks ist nicht gestattet, externe CSS-Utilities können jedoch verwendet werden.
30-
Zusätzlich muss eine `db.json`-Datei für das Backend mit den Beispiel-Daten bereitgestellt werden, die für die Korrektur der Aufgabe erforderlich sind.
29+
Ziel dieses Projekts ist es, das im virtuellen Unterricht erworbene Wissen zu üben und zu demonstrieren. Es soll eine Webanwendung entwickelt werden, die ähnlich wie Wallapop funktioniert. Die Verwendung von JavaScript-Bibliotheken oder -Frameworks ist nicht erlaubt, jedoch dürfen externe CSS-Utilities genutzt werden.
30+
Zusätzlich muss eine Datei `db.json` bereitgestellt werden, die Beispieldaten für die Korrektur enthält.
3131

32-
### 1. Anzeigenliste
32+
### 1. Beitrag-Übersicht
3333

34-
- Jede Anzeige sollte ihr Bild (falls vorhanden), den Namen, die Beschreibung, den Preis und die Angabe, ob es sich um einen Kauf oder Verkauf handelt, anzeigen.
35-
- Die Anzeigen müssen über ein Endpoint abgerufen werden.
36-
- Der Listenscreen muss alle Zustände der Benutzeroberfläche verwalten:
34+
- Jeder Beitrag soll ein Bild (falls vorhanden), einen Namen, eine Beschreibung, einen Preis und die Angabe "Kauf" oder "Verkauf" anzeigen.
35+
- Die Beiträge sollen über einen API-Endpunkt abgerufen werden.
36+
- Die Benutzeroberfläche muss alle Zustände verwalten:
3737

38-
- **Leer** (keine Anzeigen).
39-
- **Fehler** (beim Laden der Anzeigen).
40-
- **Laden** (während die Anzeigen geladen werden).
41-
- **Erfolg** (wenn die Anzeigen erfolgreich abgerufen wurden).
38+
- **Leer** (keine Beiträge vorhanden).
39+
- **Fehler** (beim Laden der Beiträge).
40+
- **Ladevorgang** (während des Ladens).
41+
- **Erfolg** (Beiträge wurden erfolgreich geladen).
4242

43-
- Durch Klicken auf eine Anzeige sollte der Benutzer zum Detailbildschirm dieser Anzeige weitergeleitet werden.
44-
- Wenn der Benutzer angemeldet ist, sollte eine Schaltfläche angezeigt werden, um zum Bildschirm zur Erstellung von Anzeigen zu gelangen.
43+
- Beim Klicken auf einen Beitrag gelangt man zur Detailansicht.
44+
- Wenn der Benutzer angemeldet ist, soll ein Button zur Beitragserstellung angezeigt werden.
4545

46-
### 2. Anzeigendetail
46+
### 2. Beitrags-Details
4747

48-
- Es sollte das Bild (falls vorhanden), den Namen, die Beschreibung, den Preis und die Angabe, ob es sich um einen Kauf oder Verkauf handelt, anzeigen.
49-
- Es sollte alle Zustände der Benutzeroberfläche verwalten:
48+
- Es sollen Bild (falls vorhanden), Name, Beschreibung, Preis und Kauf/Verkauf angezeigt werden.
49+
- Die Benutzeroberfläche muss alle Zustände verwalten:
5050

51-
- **Leer** (die Anzeige existiert nicht).
52-
- **Fehler** (beim Laden der Anzeigedaten).
53-
- **Laden** (während die Daten geladen werden).
54-
- **Erfolg** (wenn die Daten erfolgreich abgerufen wurden).
51+
- **Leer** (Beitrag existiert nicht).
52+
- **Fehler** (beim Laden der Daten).
53+
- **Ladevorgang** (während des Ladens).
54+
- **Erfolg** (Informationen wurden erfolgreich geladen).
5555

56-
- Wenn der Benutzer authentifiziert ist und die Anzeige ihm gehört, sollte eine Schaltfläche zum Löschen der Anzeige angezeigt werden (mit Bestätigung).
56+
- Ist der Benutzer authentifiziert und Eigentümer des Beitrags, soll ein Löschbutton mit Bestätigung angezeigt werden.
5757

58-
### 3. Erstellung einer Anzeige
58+
### 3. Beitrag erstellen
5959

60-
- Es sollte ein Formular mit den folgenden Feldern enthalten:
61-
- **Foto** (optional).
62-
- **Name** (erforderlich).
63-
- **Beschreibung** (erforderlich).
64-
- **Preis** (erforderlich).
65-
- **Kauf/Verkauf** (erforderlich).
60+
- Ein Formular mit folgenden Feldern muss vorhanden sein:
61+
- **Foto** (optional)
62+
- **Name** (Pflichtfeld)
63+
- **Beschreibung** (Pflichtfeld)
64+
- **Preis** (Pflichtfeld)
65+
- **Kauf/Verkauf** (Pflichtfeld)
6666

67-
- Beim Absenden des Formulars sollte eine Anfrage an das Backend gesendet werden, um die Anzeige zu speichern.
68-
- Die Benutzeroberfläche muss folgende Zustände verwalten:
67+
- Beim Absenden soll der Beitrag über eine API-Anfrage im Backend gespeichert werden.
68+
- Die Benutzeroberfläche muss folgende Zustände behandeln:
6969

70-
- **Fehler** (beim Speichern der Anzeige).
71-
- **Laden** (während die Anzeige gespeichert wird).
72-
- **Erfolg** (wenn die Anzeige erfolgreich gespeichert wurde).
70+
- **Fehler** (beim Speichern).
71+
- **Ladevorgang** (während des Speicherns).
72+
- **Erfolg** (Beitrag wurde erfolgreich gespeichert).
7373

74-
- Dieser Bildschirm kann nur aufgerufen werden, wenn der Benutzer angemeldet ist. Andernfalls wird der Benutzer zum Listenbildschirm weitergeleitet und erhält eine Nachricht mit dem Grund.
74+
- Diese Seite ist nur für angemeldete Benutzer zugänglich. Andernfalls wird man zur Übersicht umgeleitet und informiert.
7575

7676
### 4. Login
7777

78-
- Es sollte ein Formular mit den Feldern Benutzername und Passwort angezeigt werden.
79-
- Nach dem Absenden des Formulars sollte der Benutzer gegen das Backend authentifiziert werden, und ein JWT-Token sollte abgerufen werden.
80-
- Die Zustände: Laden, Fehler und Erfolg müssen verwaltet werden.
78+
- Es soll ein Formular mit Benutzername und Passwort angezeigt werden.
79+
- Beim Absenden soll der Benutzer über das Backend authentifiziert werden und ein JWT-Token erhalten.
80+
- Die ZuständeLaden“, „Fehler und Erfolg müssen verwaltet werden.
8181

8282
### 5. Registrierung
8383

84-
- Ähnlich zum Login-Bildschirm.
85-
- Der Benutzer sollte im Backend registriert werden.
86-
- Die Zustände: Laden, Fehler und Erfolg müssen verwaltet werden.
84+
- Ähnlich wie der Login-Bildschirm.
85+
- Der Benutzer soll über das Backend registriert werden.
86+
- Die ZuständeLaden“, „Fehler und Erfolg müssen verwaltet werden.
8787

8888
## Optional
8989

90-
- Pagination der Anzeigen in der Liste (die API gibt standardmäßig nur 10 zurück).
91-
- Suchfunktion für Anzeigen.
92-
- Bearbeitung von Anzeigen (nur wenn der Benutzer der Eigentümer ist).
93-
- Filterung nach Tags (Statische Tags).
94-
- Dynamische Tags ermöglichen.
90+
- Paginierung der Beiträge in der Übersicht (API liefert standardmäßig nur 10).
91+
- Suchfunktion für Beiträge.
92+
- Bearbeitung von Beiträgen (nur durch den Eigentümer).
93+
- Filterung nach statischen Tags.
94+
- Dynamische Tags implementieren.
9595

96-
## REST API für das Projekt
96+
## REST-API zur Projektunterstützung
9797

98-
Um eine Datenbank zu emulieren, wird **sparrest.js** verwendet, eine REST API, die von Dozent Alberto Casero (KeepCoding) erstellt wurde und auf `json-server` basiert.
98+
Zur Simulation einer Datenbank wird **sparrest.js** verwendeteine vom Dozenten Alberto Casero (KeepCoding) erstellte REST-API, basierend auf `json-server`.
9999

100100
### Repository klonen
101101

102102
```bash
103103
git clone https://github.com/kasappeal/sparrest.js.git
104104
```
105105

106-
Dies startet den Server und aktiviert die REST API, sodass Sie mit der simulierten Datenbank interagieren können.
106+
Dies startet den Server und stellt die REST-API bereit, sodass du mit der simulierten Datenbank interagieren kannst.
107107

108108
## Verwendete Technologien
109109

110-
- **HTML**: Zur Strukturierung des Inhalts und zum Erstellen des Seitenlayouts.
111-
- **CSS**: Für das Design und die visuelle Gestaltung der Seite, um eine attraktive und konsistente Benutzererfahrung zu gewährleisten.
110+
- **HTML**: Für die Strukturierung der Inhalte und des Seitenlayouts.
111+
- **CSS**: Für das visuelle Design und die Benutzeroberfläche, um ein konsistentes und attraktives Nutzererlebnis zu bieten.
112112

113113
## Installations- und Nutzungshinweise
114114

115115
### Softwareanforderungen
116116

117-
- **Visual Studio** (Getestet mit Version 1.99.0)
118-
- **Live Server** (Visual Studio Addon, optional)
117+
- **Visual Studio Code** (getestet mit Version 1.99.0)
118+
- **Live Server** (VS Code-Erweiterung, optional)
119119

120-
### Beschreibung der Programme
120+
### Programmbeschreibung
121121

122-
- **Visual Studio**: Integrierte Entwicklungsumgebung (IDE), die benötigt wird, um das Projekt auszuführen. Stellen Sie sicher, dass Sie Version 1.99.0 verwenden, um Kompatibilitätsprobleme zu vermeiden.
123-
- **Live Server**: Visual Studio-Erweiterung, die es ermöglicht, HTML-Dateien lokal in einem Browser anzuzeigen und Änderungen in Echtzeit anzuzeigen.
122+
- **Visual Studio Code**: Integrierte Entwicklungsumgebung (IDE) zur Projektausführung. Achte darauf, Version 1.99.0 zu verwenden, um Kompatibilitätsprobleme zu vermeiden.
123+
- **Live Server**: Erweiterung für VS Code, die eine lokale HTML-Vorschau im Browser mit Live-Reload ermöglicht.
124124

125-
### Schritte zur Verwendung dieses Projekts
125+
### Schritte zur Verwendung des Projekts
126126

127-
1. Laden Sie die komprimierte Datei des Projekts von GitHub auf Ihren Computer herunter oder klonen Sie sie über SourceTree.
127+
1. Lade die Projektdateien als ZIP von GitHub herunter oder klone das Repository mit SourceTree.
128128

129-
2. Sobald das Projekt heruntergeladen oder geklont wurde, fügen Sie es zu Ihrem Arbeitsbereich in Visual Studio Code hinzu.
129+
2. Öffne das Projekt anschließend in deinem Arbeitsbereich in Visual Studio Code.
130130

131-
3. Nachdem Sie Sparrest heruntergeladen haben, aktualisieren Sie die Abhängigkeiten. Um die getestete Datenbank in dieses Projekt zu integrieren, kopieren Sie die `db.json`-Datei aus diesem Projekt und ersetzen Sie die Datei, die von Sparrest nach der Initialisierung generiert wird.
131+
3. Nach dem Herunterladen von Sparrest aktualisiere die Abhängigkeiten. Um die in diesem Projekt verwendete Datenbank zu nutzen, kopiere die Datei `db.json` aus dem Projektordner und ersetze die automatisch generierte Datei in Sparrest.
132132

133-
Um die Datenbank zu starten, führen Sie einfach den folgenden Befehl im Sparrest-Verzeichnis aus:
133+
Starte die Datenbank mit folgendem Befehl im Sparrest-Verzeichnis:
134134

135135
```bash
136136
npm start
137137
```
138138

139139
### Hinweise
140140

141-
- Die `db.json`-Datei enthält drei Konten und 14 Beiträge. Dies sind die Anmeldeinformationen für jedes Konto, um sich im Projekt anzumelden und die bereits erstellten Beiträge zu bearbeiten:
141+
- Die Datei `db.json` enthält drei Benutzerkonten und 14 Beiträge. Folgende Zugangsdaten können verwendet werden, um sich anzumelden und bestehende Beiträge zu bearbeiten:
142142

143-
- [pablsch.it@gmail.com](mailto:pablsch.it@gmail.com) / pwd: 123456
144-
- [Pedro.it@gmail.com](mailto:Pedro.it@gmail.com) / pwd: 123456
145-
- [jose.JJ@gmail.com](mailto:jose.JJ@gmail.com) / pwd: 123456
143+
- [pablsch.it@gmail.com](mailto:pablsch.it@gmail.com) / Passwort: 123456
144+
- [Pedro.it@gmail.com](mailto:Pedro.it@gmail.com) / Passwort: 123456
145+
- [jose.JJ@gmail.com](mailto:jose.JJ@gmail.com) / Passwort: 123456
146146

147147
## Keine Beiträge oder Lizenzen
148148

docs/README.es.md

Lines changed: 40 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -18,56 +18,56 @@
1818
- Manipulación de atributos del DOM, así como de sus estilos y clases CSS.
1919
- Manejo de eventos del DOM.
2020
- Comportamientos por defecto en los componentes HTML.
21-
- Event Bubbling & Capturing.
21+
- *Event Bubbling* y *Capturing*.
2222
- Promesas y sus estados: *pending*, *fulfilled* y *rejected*.
2323
- Peticiones HTTP con `fetch`.
2424
- `localStorage` y `sessionStorage`.
2525
- Almacenamiento local de datos en HTML5: cookies, storage e IndexedDB.
2626

2727
## Descripción del proyecto
2828

29-
Con el fin de ejercitar y demostrar los conocimientos adquiridos en clases virtuales, este proyecto consiste en desarrollar una aplicación web similar a Wallapop. No se permite utilizar librerías o frameworks de JavaScript, aunque sí se pueden usar utilidades de CSS externas.
29+
Con el fin de ejercitar y demostrar los conocimientos adquiridos en clases virtuales, este proyecto consiste en desarrollar una aplicación web similar a Wallapop. No se permite utilizar librerías o *frameworks* de JavaScript, aunque sí se pueden usar utilidades de CSS externas.
3030
Además, se debe proporcionar un archivo `db.json` para el backend con los datos de ejemplo necesarios para la corrección de la práctica.
3131

32-
### 1. Listado de anuncios
32+
### 1. Listado de posts
3333

34-
- Cada anuncio debe mostrar su imagen (si tiene), nombre, descripción, precio y si es de compra o venta.
35-
- Los anuncios deben obtenerse a través de un endpoint.
34+
- Cada post debe mostrar su imagen (si tiene), nombre, descripción, precio y si es de compra o venta.
35+
- Los posts deben obtenerse a través de un *endpoint*.
3636
- La pantalla de listado debe gestionar todos los estados de la interfaz:
3737

38-
- **Vacío** (no hay anuncios).
39-
- **Error** (al cargar los anuncios).
40-
- **Carga** (mientras se cargan los anuncios).
41-
- **Éxito** (cuando los anuncios se han recuperado correctamente).
38+
- **Vacío** (no hay posts).
39+
- **Error** (al cargar los posts).
40+
- **Carga** (mientras se cargan los posts).
41+
- **Éxito** (cuando los posts se han recuperado correctamente).
4242

43-
- Al pulsar sobre un anuncio, se debe acceder a su pantalla de detalle.
44-
- Si el usuario ha iniciado sesión, debe mostrarse un botón para acceder a la pantalla de creación de anuncios.
43+
- Al pulsar sobre un post, se debe acceder a su pantalla de detalle.
44+
- Si el usuario ha iniciado sesión, debe mostrarse un botón para acceder a la pantalla de creación de posts.
4545

46-
### 2. Detalle de anuncio
46+
### 2. Detalle de post
4747

4848
- Debe mostrar imagen (si tiene), nombre, descripción, precio y si es de compra o venta.
4949
- Debe gestionar todos los estados de la interfaz:
5050

51-
- **Vacío** (no existe el anuncio).
52-
- **Error** (al cargar la información del anuncio).
51+
- **Vacío** (no existe el post).
52+
- **Error** (al cargar la información del post).
5353
- **Carga** (mientras se carga la información).
5454
- **Éxito** (cuando se ha recuperado la información correctamente).
5555

56-
- Si el usuario está autenticado y el anuncio le pertenece, debe mostrarse un botón para eliminarlo (previa confirmación).
56+
- Si el usuario está autenticado y el post le pertenece, debe mostrarse un botón para eliminarlo (previa confirmación).
5757

58-
### 3. Creación de un anuncio
58+
### 3. Creación de un post
5959

6060
- Debe incluir un formulario con los siguientes campos:
6161
- **Foto** (opcional).
6262
- **Nombre** (obligatorio).
63-
- **Descripción** (obligatorio).
63+
- **Descripción** (obligatoria).
6464
- **Precio** (obligatorio).
6565
- **Compra/Venta** (obligatorio).
6666

67-
- Al enviar el formulario, se debe hacer una petición al backend para guardar el anuncio.
67+
- Al enviar el formulario, se debe hacer una petición al backend para guardar el post.
6868
- Se deben gestionar los estados de la interfaz:
6969

70-
- **Error** (al guardar el anuncio).
70+
- **Error** (al guardar el post).
7171
- **Carga** (durante el guardado).
7272
- **Éxito** (cuando se guarda correctamente).
7373

@@ -87,48 +87,48 @@ Además, se debe proporcionar un archivo `db.json` para el backend con los datos
8787

8888
## Opcional
8989

90-
- Paginación de anuncios en el listado (la API devuelve solo 10 por defecto).
91-
- Buscador de anuncios.
92-
- Edición de anuncios (solo si el usuario es propietario).
93-
- Filtrado por etiquetas (tags) estáticas.
94-
- Hacer que los tags sean dinámicos.
90+
- Paginación de posts en el listado (la API devuelve solo 10 por defecto).
91+
- Buscador de posts.
92+
- Edición de posts (solo si el usuario es propietario).
93+
- Filtrado por etiquetas (*tags*) estáticas.
94+
- Hacer que los *tags* sean dinámicos.
9595

9696
## API REST de apoyo para la práctica
9797

98-
Para emular una base de datos se utilizará **sparrest.js**, un API REST creada por el docente Alberto Casero (KeepCoding), basada en `json-server`.
98+
Para emular una base de datos se utilizará **sparrest.js**, una API REST creada por el docente Alberto Casero (KeepCoding), basada en `json-server`.
9999

100100
### Clonación del repositorio
101101

102102
```bash
103103
git clone https://github.com/kasappeal/sparrest.js.git
104104
```
105105

106-
Esto levantará el servidor y pondrá en funcionamiento el API REST para que puedas interactuar con la base de datos simulada.
106+
Esto levantará el servidor y pondrá en funcionamiento la API REST para que puedas interactuar con la base de datos simulada.
107107

108-
## Tecnologías Utilizadas
108+
## Tecnologías utilizadas
109109

110110
- **HTML**: Para la estructuración del contenido y la creación de la estructura de la página web.
111111
- **CSS**: Para el diseño y estilo visual de la página, asegurando una experiencia de usuario atractiva y coherente.
112112

113-
## Instrucciones de Instalación y Uso
113+
## Instrucciones de instalación y uso
114114

115-
### Requisitos de Software
115+
### Requisitos de software
116116

117-
- **Visual Studio** (Testeado en la versión 1.99.0)
118-
- **Live Server** (Addon de Visual Studio, Opcional)
117+
- **Visual Studio Code** (testeado en la versión 1.99.0)
118+
- **Live Server** (addon de Visual Studio Code, opcional)
119119

120-
### Descripción de los Programas
120+
### Descripción de los programas
121121

122-
- **Visual Studio**: Entorno de desarrollo integrado (IDE) necesario para ejecutar el proyecto. Asegúrate de utilizar la versión 1.99.0 para evitar problemas de compatibilidad.
123-
- **Live Server**: Extensión de Visual Studio que permite visualizar los archivos HTML de manera local en un navegador, mostrando los cambios en tiempo real.
122+
- **Visual Studio Code**: Entorno de desarrollo integrado (IDE) necesario para ejecutar el proyecto. Asegúrate de utilizar la versión 1.99.0 para evitar problemas de compatibilidad.
123+
- **Live Server**: Extensión de Visual Studio Code que permite visualizar los archivos HTML de manera local en un navegador, mostrando los cambios en tiempo real.
124124

125-
### Pasos Para Utilizar Este Proyecto
125+
### Pasos para utilizar este proyecto
126126

127127
1. Descargue el archivo comprimido del proyecto desde GitHub a su ordenador o clónelo mediante SourceTree.
128128

129129
2. Una vez descargado o clonado el proyecto, agréguele a su espacio de trabajo en Visual Studio Code.
130130

131-
3. Una vez descargado Sparrest, actualice sus dependencias. Luego, para incorporar la base de datos probada en este proyecto, copie el archivo *db.json* del proyecto y reemplácelo por el que se genera en Sparrest una vez inicializado.
131+
3. Una vez descargado Sparrest, actualice sus dependencias. Luego, para incorporar la base de datos probada en este proyecto, copie el archivo `db.json` del proyecto y reemplácelo por el que se genera en Sparrest una vez inicializado.
132132

133133
Para iniciar la base de datos, simplemente ejecute el siguiente comando dentro del directorio de Sparrest:
134134

@@ -140,14 +140,14 @@ npm start
140140

141141
- El archivo `db.json` contiene tres cuentas y 14 publicaciones. Estas son las credenciales de cada cuenta para iniciar sesión en el proyecto y editar las publicaciones ya creadas:
142142

143-
- [pablsch.it@gmail.com](mailto:pablsch.it@gmail.com) / pwd: 123456
144-
- [Pedro.it@gmail.com](mailto:Pedro.it@gmail.com) / pwd: 123456
143+
- [pablsch.it@gmail.com](mailto:pablsch.it@gmail.com) / pwd: 123456
144+
- [Pedro.it@gmail.com](mailto:Pedro.it@gmail.com) / pwd: 123456
145145
- [jose.JJ@gmail.com](mailto:jose.JJ@gmail.com) / pwd: 123456
146146

147-
## Sin Contribuciones ni Licencias
147+
## Sin contribuciones ni licencias
148148

149149
Este proyecto no cuenta con contribuciones externas ni licencia en este momento.
150150

151-
## Vista Previa del Proyecto
151+
## Vista previa del proyecto
152152

153153
...

0 commit comments

Comments
 (0)