|
2 | 2 |
|
3 | 3 | “Show off your semantic `<body>`”: [_April 9 is CSS Naked Day!_](https://css-naked-day.org/) |
4 | 4 |
|
5 | | -If you’re participating, [add a file to the respective folder](https://github.com/css-naked-day/css-naked-day.github.io) to add your website(s). |
| 5 | +If you’re participating, add or update a [file in participants](https://github.com/css-naked-day/css-naked-day.github.io/tree/issues/160-refactor-eleventy/_src/_data/participants)! |
| 6 | + |
| 7 | +If you have been participating and are not listed, feel free to make a Pull Request and give us reasonable clues. A link to the [Web archive](https://web.archive.org/web/https://css-naked-day.org/) is always welcome, but you might also point to articles or online mentions of your participation. |
6 | 8 |
|
7 | 9 | Welcome to CSS Naked Day! |
8 | 10 |
|
| 11 | +## Data structure |
| 12 | + |
| 13 | +We are using **one file per website owner**, with your websites and participating years in the same file! Simply add years or websites as they come. |
| 14 | + |
| 15 | +We are using [Toml configuration files](https://toml.io/) to structure data. Here are examples of configurations: |
| 16 | + |
| 17 | +### Bare minimum |
| 18 | + |
| 19 | +The following will show as “_[css-naked-day.org]_”: |
| 20 | + |
| 21 | +```toml |
| 22 | +[[websites]] |
| 23 | +url = "https://css-naked-day.org/" |
| 24 | +years = [2006, 2010] |
| 25 | +``` |
| 26 | + |
| 27 | +### With a display name |
| 28 | + |
| 29 | +The following will show as “_[Naked Days Corp]_”: |
| 30 | + |
| 31 | +```toml |
| 32 | +display = "Naked Days Corp" |
| 33 | + |
| 34 | +[[websites]] |
| 35 | +url = "https://css-naked-day.org/" |
| 36 | +years = [2006, 2010] |
| 37 | +``` |
| 38 | + |
| 39 | +### With multiple websites |
| 40 | + |
| 41 | +The following will show as “_[Naked Days Corp]_” in 2006 and “_Naked Days Corp: [CSS Naked Day] & [JS Naked Day]_” in 2010: |
| 42 | + |
| 43 | +```toml |
| 44 | +display = "Naked Days Corp" |
| 45 | + |
| 46 | +[[websites]] |
| 47 | +url = "https://css-naked-day.org/" |
| 48 | +title = "CSS Naked Day" |
| 49 | +years = [2006, 2010] |
| 50 | + |
| 51 | +[[websites]] |
| 52 | +url = "https://js-naked-day.org/" |
| 53 | +title = "JS Naked Day" |
| 54 | +years = [2010] |
| 55 | +``` |
| 56 | + |
| 57 | +### Advanced formatting |
| 58 | + |
| 59 | +By default, more than one entry will be listed as “_`display`: [website1](), [website2]() & [website3]()_”. [Tom Hazeldine’s config file](https://github.com/css-naked-day/css-naked-day.github.io/blob/430c7d632bddd5d4fb1a17799ac5fc45cee49fab/_src/_data/participants/tom-hazledine.toml#L14-L16) is a good example of a more free-flow writing of entries. |
| 60 | + |
| 61 | +His websites will appear as “_Tom Hazledine: [tomhazledine.com](https://tomhazledine.com/) (some of which is [always naked](https://tomhazledine.com/css-naked-day/))_” |
| 62 | + |
| 63 | +### More than complete |
| 64 | + |
| 65 | +We are not using all data yet, but feel free to add them, as we might improve the website with it! |
| 66 | + |
| 67 | +External accounts can also be a good way to join you. |
| 68 | + |
| 69 | +```toml |
| 70 | +display = "Joan Elisabeth Lowther Murray" # [optional] |
| 71 | +firstname = "Joan Elisabeth" # [optional] |
| 72 | +surname = "Lowther Murray" # [optional] |
| 73 | +email = "joan@example.com" # [optional] |
| 74 | +username = "jelm" # [optional] |
| 75 | + |
| 76 | +# Websites |
| 77 | +# ------------------------------------------------------------------------------ |
| 78 | + |
| 79 | +[[websites]] |
| 80 | +url = "https://css-naked-day.org/" |
| 81 | +title = "CSS Naked Day" |
| 82 | +years = [2006, 2010] |
| 83 | + |
| 84 | +[[websites]] |
| 85 | +url = "https://js-naked-day.org/" |
| 86 | +title = "JS Naked Day" |
| 87 | +years = [2010] |
| 88 | + |
| 89 | +# Accounts [optional] |
| 90 | +# ------------------------------------------------------------------------------ |
| 91 | + |
| 92 | +[[accounts]] |
| 93 | +type = "Mastodon" |
| 94 | +url = "https://mas.to.don/@jelm" |
| 95 | + |
| 96 | +[[accounts]] |
| 97 | +type = "Github" |
| 98 | +url = "https://github.com/jelm.github" |
| 99 | +username = "jelm.github" # [optional] The main one is used by default |
| 100 | +``` |
| 101 | + |
9 | 102 | ## Development |
10 | 103 |
|
11 | | -The site is built using <https://www.11ty.dev/> and <https://www.npmjs.com/>. The commands are: |
| 104 | +The site is built using [Eleventy](https://www.11ty.dev/) and [npm](https://www.npmjs.com/). |
12 | 105 |
|
13 | | -### Build HTML |
| 106 | +### Build website |
14 | 107 |
|
15 | 108 | ```bash |
16 | 109 | npm run build |
17 | 110 | ``` |
18 | 111 |
|
19 | | -### Watch files and host web-server (development mode) |
| 112 | +### Host a local web-server and watch files (development mode) |
20 | 113 |
|
21 | 114 | ```bash |
22 | 115 | npm run dev |
23 | 116 | ``` |
| 117 | + |
| 118 | + |
| 119 | +[css-naked-day.org]: https://css-naked-day.org/ |
| 120 | +[Naked Days Corp]: https://css-naked-day.org/ |
| 121 | +[CSS Naked Day]: https://css-naked-day.org/ |
| 122 | +[Naked]: https://css-naked-day.org/ |
| 123 | +[JS Naked Day]: https://js-naked-day.org/ |
0 commit comments