Release notes: a story for big releases, and the 2.0 story
A CHANGELOG section may open with prose before its first bullet. The build bakes it into the page and version.json, and "What's new" tells it in full with a link to every change on GitHub instead of the first sentences of five bullets. The 2.0.0 section gets its story and every change grouped under headings, Architect runs included.
This commit is contained in:
parent
dbd2fa7b55
commit
abd55c0846
8 changed files with 150 additions and 49 deletions
|
|
@ -4,6 +4,8 @@
|
|||
const APP_VERSION='__VERSION__';
|
||||
// Filled in by scripts/build.sh from CHANGELOG.md for this version.
|
||||
const RELEASE_NOTES=/*__RELEASE_NOTES__*/[];
|
||||
// A big release's story, shown in full in "What's new" (paragraphs; **bold** allowed). Empty for most releases.
|
||||
const RELEASE_STORY=/*__RELEASE_STORY__*/[];
|
||||
const IS_DEV=APP_VERSION.startsWith('__');
|
||||
// Only report from the real site; previews, localhost and the Claude viewer stay silent.
|
||||
const ANALYTICS={host:/(^|\.)seriesoftub\.es$/.test(location.hostname)?'https://stats.seriesoftub.es':'',site:'seriesoftub.es'};
|
||||
|
|
|
|||
|
|
@ -30,13 +30,13 @@ function showTitle(){
|
|||
}
|
||||
// "What's new": shown once to returning players after an update, or on demand.
|
||||
function whatsNew(returning,force){
|
||||
if(IS_DEV||!RELEASE_NOTES.length)return false;let seen=null;
|
||||
if(IS_DEV||(!RELEASE_NOTES.length&&!RELEASE_STORY.length))return false;let seen=null;
|
||||
try{seen=localStorage.getItem('sot-seen-version');localStorage.setItem('sot-seen-version',APP_VERSION);}catch(e){}
|
||||
if(!force&&(!returning||seen===APP_VERSION))return false;
|
||||
openModal(`<div style="display:flex;align-items:center"><div><div class="eyebrow">${tr('common.release_notes')}</div><h2 style="font-size:28px">${tr('title.new_in_series_of_tubes_v',{v:esc(APP_VERSION)})}</h2></div><button class="x" data-act="${UI.started?'closeModal':'helpClose'}" aria-label="${tr('common.close')}">×</button></div>
|
||||
${notesHtml(RELEASE_NOTES,APP_VERSION)}
|
||||
${returning&&S?`<p class="note">${tr('title.your_network_name_was_saved_and',{name:esc(S.name)})}</p>`:''}
|
||||
<div class="btns" style="margin-top:12px">${btn(UI.started?tr('title.back_to_my_network'):tr('common.got_it'),UI.started?'closeModal':'helpClose',{},'pink big')}${notesLong(RELEASE_NOTES)?'':`<a class="b ghost" href="https://github.com/fjaeckel/seriesoftubes/blob/main/CHANGELOG.md" target="_blank" rel="noopener">${tr('common.full_changelog')}</a>`}</div>`);
|
||||
<div class="btns" style="margin-top:12px">${btn(UI.started?tr('title.back_to_my_network'):tr('common.got_it'),UI.started?'closeModal':'helpClose',{},'pink big')}${notesLong(RELEASE_NOTES)||RELEASE_STORY.length?'':`<a class="b ghost" href="https://github.com/fjaeckel/seriesoftubes/blob/main/CHANGELOG.md" target="_blank" rel="noopener">${tr('common.full_changelog')}</a>`}</div>`);
|
||||
return true;}
|
||||
/* The four doors: one game, its rules picked here and locked for the network's life. Normal and Sandbox stay on this
|
||||
screen (presets / chaos below), Puzzles and Scenarios open their own lists. Choices toggle in place (no re-render). */
|
||||
|
|
|
|||
|
|
@ -3,7 +3,9 @@
|
|||
const NOTE_MAX=5,NOTE_CH=140;
|
||||
function slimNote(n){const m=String(n).match(/^(.+?[.!?])(\s|$)/);let t=m?m[1]:String(n);if(t.length>NOTE_CH)t=t.slice(0,NOTE_CH-1).replace(/\s+\S*$/,'')+'…';return t;}
|
||||
const notesLong=ns=>ns.length>NOTE_MAX||ns.some(n=>slimNote(n)!==n);
|
||||
function notesHtml(ns,ver){const more=Math.max(0,ns.length-NOTE_MAX);
|
||||
// A release with a story tells it in full, then points to every change on GitHub.
|
||||
const storyHtml=(ps,ver)=>`<div class="story">${ps.map(p=>`<p>${esc(p).replace(/\*\*(.+?)\*\*/g,'<b>$1</b>')}</p>`).join('')}</div><p style="margin:6px 0 0"><a class="b pink sm" href="https://github.com/fjaeckel/seriesoftubes/releases/tag/v${esc(ver)}" target="_blank" rel="noopener">${tr('release_notes.read_the_full_notes_on_github')}</a></p>`;
|
||||
function notesHtml(ns,ver){if(RELEASE_STORY.length&&ver===APP_VERSION&&ns===RELEASE_NOTES)return storyHtml(RELEASE_STORY,ver);const more=Math.max(0,ns.length-NOTE_MAX);
|
||||
return `<ul class="notes">${ns.slice(0,NOTE_MAX).map(n=>`<li>${esc(slimNote(n))}</li>`).join('')}${more?`<li class="meta">${trn('release_notes.and_n_more_change',more)}</li>`:''}</ul>`+
|
||||
(notesLong(ns)?`<p style="margin:6px 0 0"><a class="b pink sm" href="https://github.com/fjaeckel/seriesoftubes/releases/tag/v${esc(ver)}" target="_blank" rel="noopener">${tr('release_notes.read_the_full_notes_on_github')}</a></p>`:'');}
|
||||
function newerVer(a,b){const x=String(a).split('.').map(Number),y=String(b).split('.').map(Number);for(let i=0;i<3;i++){if((x[i]||0)>(y[i]||0))return true;if((x[i]||0)<(y[i]||0))return false;}return false;}
|
||||
|
|
|
|||
|
|
@ -67,6 +67,9 @@ label.f+select.pick{width:100%}
|
|||
#update .b{pointer-events:auto}
|
||||
.notes{margin:10px 0 0;padding-left:20px;line-height:1.5}
|
||||
.notes li{margin:4px 0}
|
||||
.story{margin:10px 0 0;line-height:1.5}
|
||||
.story p{margin:0 0 10px}
|
||||
.story b{font-weight:900}
|
||||
#bankBox{position:fixed;inset:0;background:rgba(30,38,64,.35);z-index:16;overflow:auto;padding:calc(env(safe-area-inset-top,0px) + 12px) max(12px,env(safe-area-inset-right,0px)) 16px max(12px,env(safe-area-inset-left,0px))}
|
||||
#bankCard{max-width:760px;margin:0 auto;padding:16px 18px 18px;background:var(--paper)}
|
||||
.menubtn{cursor:pointer;text-align:left;font:inherit;border-color:var(--ink)}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue