Skip to content

Commit 9c762ec

Browse files
fmeolafmeola
committed
Added cards in starting page for the newest tutorials
1 parent e5bd17d commit 9c762ec

File tree

5 files changed

+139
-136
lines changed

5 files changed

+139
-136
lines changed

‎Writerside/t.tree‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,5 +29,7 @@
2929
<toc-element topic="Install-Archetype.md"/>
3030
<toc-element topic="New-Project-with-Archetype.md"/>
3131
<toc-element topic="Project-Execution.md"/>
32+
<toc-element topic="New-Project-from-IntelliJ.md"/>
33+
<toc-element topic="IntelliJ-Use-With-Archetype.md"/>
3234
</toc-element>
3335
</instance-profile>

‎Writerside/topics/IntelliJ-Use-With-Archetype.md‎

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
# Uso de IntelliJ
2+
3+
**Para abrir el proyecto recién creado con IntelliJ IDEA.**
4+
5+
1. Desde el IntelliJ elegir la opción <shortcut>Open</shortcut> para abrir un nuevo proyecto
6+
7+
![intellij-archetype-1.png](intellij-archetype-1.png)
8+
9+
2. Desde el explorador de archivos emergente elegir el **pom.xml del directorio raíz del proyecto**.
10+
11+
En este ejemplo es <code>sample-project/pom.xml</code>
12+
13+
3. Elegir <shortcut>Open as Project</shortcut>
14+
15+
![intellij-archetype-2.png](intellij-archetype-2.png)
16+
17+
4. Desde el menú de <shortcut>Maven</shortcut> puede ejecutar los comandos <code>mvn clean</code> y
18+
<code>mvn package</code> sin recurrir a la terminal
19+
20+
![intellij-archetype-3.png](intellij-archetype-3.png)
21+
22+
<tip>
23+
24+
Recordar de siempre seleccionar el módulo parent
25+
(en este ejemplo <code>sample-project-parent</code>)
26+
27+
</tip>
28+
29+
## Solución de Problemas
30+
31+
<tip>
32+
33+
En el caso de que **el IDE no reconozca archivos que se generaron con el proyecto** recomendamos intentar
34+
las siguientes opciones desde el menú contextual (click derecho) sobre el archivo **pom.xml del módulo padre**:
35+
36+
1. **Generate Sources and Update Folders**
37+
38+
2. **Sync Project**
39+
40+
![intellij-archetype-4.png](intellij-archetype-4.png)
41+
42+
</tip>

‎Writerside/topics/New-Project-from-IntelliJ.md‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# Nuevo proyecto desde IntelliJ
2+
3+
Otra opción para crear un proyecto usando el arquetipo consiste en **indicarle a IntelliJ
4+
qué arquetipo queremos usar.**
5+
6+
1. Desde el IntelliJ elegir la opción <shortcut>New Project</shortcut> para crear un nuevo proyecto
7+
8+
![intellij-archetype-1.png](intellij-archetype-1.png)
9+
10+
2. En la sección izquierda de <shortcut>Generators</shortcut>
11+
elegir <shortcut>Maven Archetype</shortcut>
12+
13+
3. Antes de completar los campos para crear el proyecto dirigirse a la opción
14+
<shortcut>Manage catalogs...</shortcut>
15+
16+
![intellij-archetype-wizard-1.png](intellij-archetype-wizard-1.png)
17+
18+
4. En la ventana emergente de
19+
<shortcut>Manage Catalog</shortcut>
20+
hacer click en el botón
21+
<shortcut>+</shortcut>
22+
para agregar un nuevo catálogo
23+
24+
![intellij-archetype-wizard-2.png](intellij-archetype-wizard-2.png)
25+
26+
5. En la ventana emergente de
27+
<shortcut>Add Catalog</shortcut>
28+
hacer click en la carpeta y navegar hasta el archivo
29+
<code>archetype-catalog.xml</code>
30+
31+
Según el sistema operativo, asumiendo un nombre de usuario **Foo**, el archivo se encuentra ubicado en:
32+
33+
<tabs>
34+
<tab id="macos-catalog" title="macOS">
35+
<code-block lang="console">
36+
/Users/Foo/.m2/archetype-catalog.xml
37+
</code-block>
38+
</tab>
39+
<tab id="linux-catalog" title="Linux">
40+
<code-block lang="console">
41+
/home/Foo/snap/strictly-maven/common/repository/archetype-catalog.xml
42+
</code-block>
43+
</tab>
44+
<tab id="windows-catalog" title="Windows">
45+
<code-block lang="console">
46+
C:/Users/Foo/.m2/archetype-catalog.xml
47+
C:/Usuarios/Foo/.m2/archetype-catalog.xml
48+
</code-block>
49+
</tab>
50+
</tabs>
51+
52+
![Screenshot 2025-01-17 at 14.35.41.png](intellij-archetype-wizard-3.png)
53+
54+
Guardar los cambios con
55+
<shortcut>Add</shortcut>.
56+
57+
6. De vuelta en la ventana de
58+
<shortcut>Manage Catalog</shortcut>
59+
debería ver algo similar a lo siguiente:
60+
61+
![intellij-archetype-wizard-4.png](intellij-archetype-wizard-4.png)
62+
63+
Guardar los cambios con
64+
<shortcut>OK</shortcut>.
65+
66+
7. De vuelta en la ventana de
67+
<shortcut>New Project</shortcut> elegir en
68+
<shortcut>Catalog</shortcut>
69+
la opción recién creada
70+
71+
8. En
72+
<shortcut>Archetype</shortcut>
73+
elegir la opción
74+
<code>ar.edu.itba.pod:pod-mp-grpc-archetype</code>
75+
76+
9. Completar los demás campos de la ventana de
77+
<shortcut>New Project</shortcut> (en este ejemplo crearemos un archivo llamado <code>my-project</code>)
78+
y presionar <shortcut>Create</shortcut>
79+
80+
![intellij-archetype-wizard-5.png](intellij-archetype-wizard-5.png)

‎Writerside/topics/New-Project-with-Archetype.md‎

Lines changed: 0 additions & 124 deletions
Original file line numberDiff line numberDiff line change
@@ -100,127 +100,3 @@ Debería obtener una salida similar a la siguiente:
100100
[INFO] Finished at: 2025-01-15T16:46:43-03:00
101101
[INFO] ------------------------------------------------------------------------
102102
</code-block>
103-
104-
## Uso de IntelliJ
105-
106-
**Para abrir el proyecto recién creado con IntelliJ IDEA.**
107-
108-
1. Desde el IntelliJ elegir la opción <shortcut>Open</shortcut> para abrir un nuevo proyecto
109-
110-
![intellij-archetype-1.png](intellij-archetype-1.png)
111-
112-
2. Desde el explorador de archivos emergente elegir el **pom.xml del directorio raíz del proyecto**.
113-
114-
En este ejemplo es <code>sample-project/pom.xml</code>
115-
116-
3. Elegir <shortcut>Open as Project</shortcut>
117-
118-
![intellij-archetype-2.png](intellij-archetype-2.png)
119-
120-
4. Desde el menú de <shortcut>Maven</shortcut> puede ejecutar los comandos <code>mvn clean</code> y
121-
<code>mvn package</code> sin recurrir a la terminal
122-
123-
![intellij-archetype-3.png](intellij-archetype-3.png)
124-
125-
<tip>
126-
127-
Recordar de siempre seleccionar el módulo parent
128-
(en este ejemplo <code>sample-project-parent</code>)
129-
130-
</tip>
131-
132-
## Nuevo proyecto desde IntelliJ
133-
134-
Otra opción para crear un proyecto usando el arquetipo consiste en **indicarle a IntelliJ
135-
qué arquetipo queremos usar.**
136-
137-
1. Desde el IntelliJ elegir la opción <shortcut>New Project</shortcut> para crear un nuevo proyecto
138-
139-
![intellij-archetype-1.png](intellij-archetype-1.png)
140-
141-
2. En la sección izquierda de <shortcut>Generators</shortcut>
142-
elegir <shortcut>Maven Archetype</shortcut>
143-
144-
3. Antes de completar los campos para crear el proyecto dirigirse a la opción
145-
<shortcut>Manage catalogs...</shortcut>
146-
147-
![intellij-archetype-wizard-1.png](intellij-archetype-wizard-1.png)
148-
149-
4. En la ventana emergente de
150-
<shortcut>Manage Catalog</shortcut>
151-
hacer click en el botón
152-
<shortcut>+</shortcut>
153-
para agregar un nuevo catálogo
154-
155-
![intellij-archetype-wizard-2.png](intellij-archetype-wizard-2.png)
156-
157-
5. En la ventana emergente de
158-
<shortcut>Add Catalog</shortcut>
159-
hacer click en la carpeta y navegar hasta el archivo
160-
<code>archetype-catalog.xml</code>
161-
162-
Según el sistema operativo, asumiendo un nombre de usuario **Foo**, el archivo se encuentra ubicado en:
163-
164-
<tabs>
165-
<tab id="macos-catalog" title="macOS">
166-
<code-block lang="console">
167-
/Users/Foo/.m2/archetype-catalog.xml
168-
</code-block>
169-
</tab>
170-
<tab id="linux-catalog" title="Linux">
171-
<code-block lang="console">
172-
/home/Foo/snap/strictly-maven/common/repository/archetype-catalog.xml
173-
</code-block>
174-
</tab>
175-
<tab id="windows-catalog" title="Windows">
176-
<code-block lang="console">
177-
C:/Users/Foo/.m2/archetype-catalog.xml
178-
C:/Usuarios/Foo/.m2/archetype-catalog.xml
179-
</code-block>
180-
</tab>
181-
</tabs>
182-
183-
![Screenshot 2025-01-17 at 14.35.41.png](intellij-archetype-wizard-3.png)
184-
185-
Guardar los cambios con
186-
<shortcut>Add</shortcut>.
187-
188-
6. De vuelta en la ventana de
189-
<shortcut>Manage Catalog</shortcut>
190-
debería ver algo similar a lo siguiente:
191-
192-
![intellij-archetype-wizard-4.png](intellij-archetype-wizard-4.png)
193-
194-
Guardar los cambios con
195-
<shortcut>OK</shortcut>.
196-
197-
7. De vuelta en la ventana de
198-
<shortcut>New Project</shortcut> elegir en
199-
<shortcut>Catalog</shortcut>
200-
la opción recién creada
201-
202-
8. En
203-
<shortcut>Archetype</shortcut>
204-
elegir la opción
205-
<code>ar.edu.itba.pod:pod-mp-grpc-archetype</code>
206-
207-
9. Completar los demás campos de la ventana de
208-
<shortcut>New Project</shortcut> (en este ejemplo crearemos un archivo llamado <code>my-project</code>)
209-
y presionar <shortcut>Create</shortcut>
210-
211-
![intellij-archetype-wizard-5.png](intellij-archetype-wizard-5.png)
212-
213-
## Solución de Problemas
214-
215-
<tip>
216-
217-
En el caso de que **el IDE no reconozca archivos que se generaron con el proyecto** recomendamos intentar
218-
las siguientes opciones desde el menú contextual (click derecho) sobre el archivo **pom.xml del módulo padre**:
219-
220-
1. **Generate Sources and Update Folders**
221-
222-
2. **Sync Project**
223-
224-
![intellij-archetype-4.png](intellij-archetype-4.png)
225-
226-
</tip>

‎Writerside/topics/Starting-Page.topic‎

Lines changed: 15 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -27,29 +27,32 @@
2727
<a href="Install-Maven.md" type="library" summary="Instalación en macOS, Linux y Windows">Instalación de Maven</a>
2828
</spotlight>
2929

30-
<!-- Optionally add additional cards and links to topics that are not in this section but may be relevant. -->
31-
<misc>
32-
<cards>
33-
<title>Instalación de Herramientas</title>
34-
<a href="Install-IntelliJ.md" type="computer"/>
35-
<a href="Install-Archetype.md" type="documents"/>
36-
</cards>
30+
<primary>
31+
<title>Instalación de Herramientas</title>
32+
<a href="Install-IntelliJ.md" type="computer"/>
33+
<a href="Install-Archetype.md" type="documents"/>
34+
</primary>
35+
36+
<secondary>
37+
<title>Uso del Arquetipo</title>
38+
<a href="New-Project-with-Archetype.md" type="development"/>
39+
<a href="Project-Execution.md" type="mixed"/>
40+
</secondary>
3741

42+
<misc>
3843
<cards>
39-
<title>Nuevo Proyecto</title>
40-
<a href="New-Project-with-Archetype.md" type="offer"/>
41-
<a href="Project-Execution.md" type="check-list"/>
44+
<title>Uso del IntelliJ</title>
45+
<a href="New-Project-from-IntelliJ.md" type="development"/>
46+
<a href="IntelliJ-Use-With-Archetype.md" type="mixed"/>
4247
</cards>
4348

44-
4549
<links>
4650
<group>
4751
<title>Más</title>
4852
<a href="https://www.jenv.be" summary="jEnv is a command line tool to help you forget how to set
4953
the JAVA_HOME environment variable">jEnv</a>
5054
</group>
5155
</links>
52-
5356
</misc>
5457
</section-starting-page>
5558

0 commit comments

Comments
 (0)