patches and low-level development discussion
 help / color / mirror / code / Atom feed
blob b691d4d2281ccd55e3114a5e21efc54399105715 920 bytes (raw)
name: Documentation/doc/contributing/building-documentation.adoc 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
= Building Documentation
:page-nav_order: 4

// SPDX-FileCopyrightText: 2022 Unikie
// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0

Make sure you have https://nixos.org/download.html[Nix] installed.
You may also want to xref:../installation/binary-cache.adoc[configure the Spectrum
binary cache], to avoid having to wait for dependencies to compile on
your local system.

. Get a copy of the Spectrum source code:
+
[source,shell]
----
git clone https://spectrum-os.org/git/spectrum
----
. Enter the documentation directory:
+
[source,shell]
----
cd spectrum/Documentation
----
. Run a server for previewing changes locally:
+
[source,shell]
----
nix-shell --run 'jekyll serve'
----
+
This will serve a local copy of the documentation at http://localhost:4000/.

After making changes to the documentation, see how to
xref:first-patch.adoc[send your patch] and submit the changes for review.

debug log:

solving b691d4d2 ...
found b691d4d2 in https://spectrum-os.org/git/spectrum

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://spectrum-os.org/git/doc
	https://spectrum-os.org/git/mktuntap
	https://spectrum-os.org/git/spectrum
	https://spectrum-os.org/git/ucspi-vsock

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).