GitHub XSLT Monthly Trending Repositories

usnistgov/OSCAL

Open Security Controls Assessment Language (OSCAL)

NIST is developing the Open Security Controls Assessment Language (OSCAL), a set of hierarchical, XML-, JSON-, and YAML-based formats that provide a standardized representations of information pertaining to the publication, implementation, and assessment of security controls. OSCAL is being developed through a collaborative approach with the public. Public contributions to this project are welcome.

With this effort, we are stressing the agile development of a set of minimal formats that are both generic enough to capture the breadth of data in scope (controls specifications), while also capable of ad-hoc tuning and extension to support peculiarities of both (industry or sector) standard and new control types.

The OSCAL website provides an overview of the OSCAL project, including an XML and JSON schema reference, examples, and other resources.

If you are interested in contributing to the development of OSCAL, refer to the contributor guidance for more information.

Project Repositories

Repository	Description
OSCAL	The main OSCAL project that contains the source code for the OSCAL models.
OSCAL-Pages	The project that contains the public OSCAL website content.
OSCAL-Reference	The project that contains the model documentation and developer reference content.
OSCAL-Content	The project that contains examples of OSCAL model content.
OSCAL-DEFINE	The project for managing research into the development and enhancement of OSCAL.

Project Status

To view the latest release of OSCAL check out GitHub releases. Each release on that page provides a complete summary of the changes made in each release.

The changes made in each release are based on the excellent feedback and contributions that are received from the OSCAL community. The NIST OSCAL team is very thankful for all of it.

Any feedback may be emailed to the NIST OSCAL team at oscal@nist.gov or by creating an issue on the GitHub repository.

Looking forward, the NIST OSCAL team is excited to continue working with the OSCAL community to continue enhancing OSCAL through additional minor releases. Future efforts will include providing a more complete set of documentation for all the OSCAL layers and models, creating more examples, and providing a diverse set of tutorials.

For additional information on the OSCAL project, please see the NIST’s Cybersecurity Insights blog: “The Foundation for Interoperable and Portable Security Automation is Revealed in NIST’s OSCAL Project” and the OSCAL website.

The NIST team is also maintaining OSCAL content that is updated to the latest OSCAL revision. The OSCAL content repository provides OSCAL examples, in addition to:

The NIST SP 800-53 revision 5 catalog and the security and privacy NIST SP 800-53B baselines.
The NIST SP 800-53 revision 4 catalog and the three NIST SP 800-53 revision 4 baselines - preserved for historic purpose.
The CSF v2.0 catalog.
The NIST SP 800-171 revision 3 catalog.
The NIST SP 800-218 version 1 catalog.

All of this OSCAL content is provided in XML, JSON and YAML formats.

NIST is also seeking tool developers, vendors, and service providers that would like to implement the OSCAL models in commercial and open-source offerings. NIST is also seeking software and service providers that are willing to work with us to represent control implementation information about their products.

To provide feedback, to ask questions, or to let us know about an OSCAL implementation you are working on, please email the NIST OSCAL team at oscal@nist.gov. You can also post publicly to the OSCAL development list: oscal-dev@list.nist.gov or create an issue on our GitHub repository.

Please find instructions for joining the OSCAL development and update lists on our contacts page. If you have any questions about OSCAL in general or if you would like to get involved in the OSCAL project, please contact us at: oscal@nist.gov or on Gitter.

Cloning this repository

Run the following Git command to clone the OSCAL repository.

git clone --recurse-submodules https://github.com/usnistgov/OSCAL.git

briankavanaugh/APA-7th-Edition

Microsoft Word XSD for generating APA 7th edition references

APA 7th Edition for Microsoft Word

Until (unless) Microsoft gets around to adding a template for the latest version, this is the APA 7th Edition XSLT modified by Mike Slagle, plus the two additional fixes posted in the comments found here. This way, if other changes are needed, this file can be updated.

IMPORTANT: These files are provided as a courtesy to those needing a better option for APA 7 than what Microsoft currently provides. I did not create the template. If there are issues, take the time to make the changes necessary (if possible; there are limitations to what can be done) and submit a pull request.

How to Use

Windows

Manual Method

Exit Word
Using Windows Explorer, copy the file APASeventhEdition.xsl to C:\Users<your_user_name>\AppData\Roaming\Microsoft\Bibliography\Style
Restart Word and from the References tab in Word, you should be able to choose APA7.

Bat file method / Cmd method

Exit word
Copy the APASeventhEdition.bat file and allow it to run.
Restart Word and from the References tab in Word, you should be able to choose APA7.

Note: The bat file simply runs the following line:

curl https://raw.githubusercontent.com/briankavanaugh/APA-7th-Edition/main/APASeventhEdition.xsl -o "%appdata%\Microsoft\Bibliography\Style\APASeventhEdition.xsl"

MacOS

Manual method

Exit Word
Using Finder, copy the file APASeventhEdition.xsl to two locations:
1. HD/Applications/Microsoft Word.app/Contents/Resources/Style/ (note that you will have to right-click and "View Contents" on the app icon at HD/Applications/Microsoft Word.app/)
2. HD/Users/<your_user_name>/Library/Containers/com.microsoft.Word/Data/Library/Application Support/Microsoft/Office/Style/
Restart Word and from the References tab in Word, you should be able to choose APA7.

Shell script method / terminal method

The file asks for elevated priveliges using sudo. Only run files you trust and understand the contents of.

Exit word and ensure it is closed before proceeding
Copy the APASeventhEdition.sh file to a local folder
Open the terminal (Search "Terminal through spotlight)
Navigate to the folder containing the shell script
1. cd /path/to/your/file
Run the script
1. bash APASeventhEdition.sh
2. Enter password when prompted. The terminal stay blank while password is entered. Once entered, press enter
3. The files should be placed in their corresponding folders
4. Optionally: run the script with the --persist flag to create a LaunchDaemon. The LaunchDaemon will copy the files into their respective folders at reboot to combat issue where Microsoft AutoUpdater removes the files: bash APASeventhEdition.sh --persist.

Notes:

The bash file will use the curl command to retrieve the file from github at the specified link and place it in /Library/Application Support/APAStyleTool.
Then it will copy the stylesheet into the two specified folders.
If the --persist flag is used a LaunchDaemon is created. This will copy the file from the /Library/Application Support/APAStyleTool folder to the two Word-folders every time the computer is rebooted.
Be aware, that the LaunchDaemon is run at boot and has root privileges to avoid user interaction. Always read the script before running it.
I do not have a Mac to test this on. The script was run successfully on a Mac with Office installed.

Disclaimer

(same as Mike's) I am only providing this file and the necessary location for it for education purposes. If any installations of MS Office are corrupted as a result of using this file, I am not responsible to address or repair any issues.

usnistgov/oscal-content

NIST SP 800-53 content and other OSCAL content examples

OSCAL Examples

This directory contains numerous OSCAL examples in XML, JSON, and YAML formats based on the latest OSCAL stable release.

These files are maintained by a Continuous Integration and Continuous Deployment (CI/CD) process that automatically converts source content into the alternate formats found in the many subdirectories of this repository. As a result, these example files should not be modified. Instead, the source of the file should be edited in the src subdirectories.

The structure and contents of the examples directory are as follows:

examples: This directory contains sample OSCAL content organized by OSCAL model.
nist.gov/SP800-53/rev4: This directory contains OSCAL examples of the catalog, and low, moderate, and high baselines defined by NIST Special Publication (SP) 800-53 Revision 4.
nist.gov/SP800-53/rev5: This directory contains OSCAL examples of the catalog, and low, moderate, and high baselines defined by NIST Special Publication (SP) 800-53 Revision 5 and SP 800-53B respectively.
src: This directory contains the source files for all the OSCAL examples located in this repository.
build: This directory includes instructions and tools to build OSCAL dependencies, generate, convert, and check example content in this repository for release.

codingo/BibWord

Microsoft Word and Bibliography Styles extender.

Credit / Foreward

This work is only made possible by the original work of Yves Dhondt (yves.dhondt@gmail.com) and his original project, found at https://bibword.codeplex.com/. I have created this project to preserve this work as it will otherwise disappear with the closure of CodePlex and I found it invaluable in my own studies. I will aim to keep this up to date (feel free to raise issues) however should the original project be migrated to another source I will be closing this in favor of one maintained by its original author.

Installation

To get the style files find the desired file using the above links. Once found, look for a button labelled "Raw". Either right-click this button and select "save linked content as" or, or click the button and right-click to save-as. Note that once downloaded, ensure that the filename extension is .xsl, some browsers will append .txt. Windows, by default hides file extensions.

To use the bibliography styles, they have to be copied into the Microsoft Word bibliography style directory. This directory can vary depending on where Word is installed. Once the styles are copied to the directory, they will show up every time Microsoft Word is opened.

It should be noted that on a 64 bit machine you have "Program Files" and "Program Files (x86)". For the majority of cases the style folder will be located within Program Files x86. Locations where files should then be installed are as follows:

Windows

Word 2007

<winword.exe directory>\Bibliography\Style

Word 2010

<winword.exe directory>\Bibliography\Style

Word 2010 (32 bit systems)

%programfiles%\Microsoft Office\Office14\Bibliography\Style

Word 2016 (Office 365)

C:\Users<currentusername>\AppData\Roaming\Microsoft\Bibliography\Style or %AppData%\Microsoft\Templates\LiveContent\15\Managed\Word Document Bibliography Styles

Mac OS

Word 2008 and Word 2011

To use the bibliography styles, right-click on Microsoft Word 2008 and select show package contents. Put the files in:

Contents/Resources/Style/ On most Macs with Microsoft Word 2008 this will be: /Applications/Microsoft Office 2008/Microsoft Word.app/Contents/Resources/Style/

Word 2016 for Mac (version 15.17.0 and up)

To use the bibliography styles, place them in the following folder

/Library/AppSupport/Microsoft/Office365/Citations/ More information can be found here: https://msdn.microsoft.com/VBA/Word-VBA/articles/create-custom-bibliography-styles?f=255&MSPPError=-2147217396

Office 365

For the latest releases of Office 365 these need to be placed within the application at:

/Applications/Microsoft Word.app/Contents/Resources/Style

To do this, open Finder, right click on /Application/Microsoft Word (or /Application/Microsoft Word.app - depending on your Finder Preferences), then click Show Package Contents to see the folders within the .app file.

FAQ

Why is a new style not showing up in Word when I add it to the Style directory?

The list of available reference styles gets loaded only once. So when you add a new style to the style directory, you need to restart Word.

In Word 2008, new styles are only added for citations. How can I use the new styles for bibliographies?

Add the bibliography using one of the four predefined styles. Then go to the citation toolbox and select the style you want. This will update all the citations and bibliographies in your text to the new style.

Why does it take Word so long to show the dropdown list with style names the first time?

Word has to retrieve the style names of every XSL in the style directory the first time. Hence, the more styles you put in the directory, the more time Word needs to fill the drop down list.

Why do I get 'BO' instead of a number when using certain styles?

'BO' is often printed when the BibOrder number is not available. Use the BibWord Extender tool on the document to add the missing numbers.

Why do certain styles have a * at the end of their name?

Although the usage of a * is not mandatory, it often indicates that part of the functionality of the style can only be used in combination with the BibWord Extender tool.

Can I request to get a certain style?

No. Using BibWord, you really should try to create the style yourself. Keep in mind that even if you find someone prepared to create the style for you that you will have to provide him/her with detailed information about the formatting guidelines for your style. Messages containing "I need style x." will most likely be ignored.

Can I (not) link my in-text citations to their bibliography entries?

Yes. Set the value of citation_as_link to 'yes' if you want in-text citations to link to their specific bibliography entry, or to any other value if you do not.

Can I change the surrounding brackets for in-text citations?

Yes. You can change the surrounding brackets by changing the values of openbracket and closebracket

<openbracket>(</openbracket>
<closebracket>)</closebracket>

How do I get my in-text citations in superscript?

In-text citations inherit the style of their surroundings. Only limited formatting (bold, underline, italic) can be applied to them through the reference style. For any further formatting, such as superscript, a character style has to be applied to all CITATION fields.

The following macro creates a character style called In-Text Citation if it does not yet exist. When the style is newly created, it sets the font to superscript. Then the style is applied to all CITATION fields in the document. By changing/updating the style In-Text Citation you can then update the formatting of all citations

Sub ApplyCitationStyle()
    Dim stylename As String
    Dim exists As Boolean
    Dim s As Style
    Dim fld As Field
                
    stylename = "In-Text Citation"
        
    ' Check if the style already exists.
    exists = False
        
    For Each s In ActiveDocument.Styles
        If s.NameLocal = stylename Then
           exists = True
           Exit For
        End If
    Next
    
    ' If the style did not exist yet, create it.
    If exists = False Then
        Set s = ActiveDocument.Styles.Add(stylename, wdStyleTypeCharacter)
        s.BaseStyle = ActiveDocument.Styles(wdStyleDefaultParagraphFont).BaseStyle
        s.Font.Superscript = True
    End If
    
    ' Now that the style really exists, select it.
    Set s = ActiveDocument.Styles(stylename)
     
    ' Apply the style to all in-text citations.
    For Each fld In ActiveDocument.Fields
        If fld.Type = wdFieldCitation Then
            fld.Select
            Selection.Style = s
        End If
    Next

End Sub

How do I convert all my in-text citations to static text in one go?

You can use the following macro to convert all in-text citations:

Sub CitationsToStaticText()
    Dim fld As Field
            
    ' Go over all stories, including main, footnotes, ...
    For Each sr In ActiveDocument.StoryRanges
        ' Find all citation fields and convert them to static text.
        For Each fld In sr.Fields
            If fld.Type = wdFieldCitation Then
                fld.Select
                WordBasic.BibliographyCitationToText
            End If
        Next
    Next

End Sub

Is there an easy way to get rid of sources which are not cited in the text?

You can use the following macro to remove all uncited sources from a document:

Sub RemoveUnusedCitations()
    ' Get the number of sources.
    idx = ActiveDocument.Bibliography.Sources.Count
    
    ' Remmove unused sources starting from the last one.
    Do While (idx > 0)
        If ActiveDocument.Bibliography.Sources(idx).Cited = False Then
            ActiveDocument.Bibliography.Sources(idx).Delete
        End If
        idx = idx - 1
    Loop
End Sub

How do I set the indentation of my bibliography?

Add a bibliography to your document. Open the 'Styles' pane (CTRL+ALT+SHIFT+S) and look for a style called 'Bibliography' (or a localized translation of the word 'Bibliography'). Change the indentation settings there. That way, whenever your bibliography gets updated, the indentation will remain correct.

Is it possible to group several citations? Currently I have something like (1)(2) and I want (1,2).

Yes. You can add a second source to a citation by using the '\m' switch and the tag of the source you want to add. In Word 2007, if you want to add a source with tag 'Bee99' to an existing citation, right click the citation and select 'Edit Field...'. It will show you something like 'CITATION Gup97 \l 2060'. To add the extra source, change it to 'CITATION Gup97 \l 2060 \m Bee99'. For more information, also see the Microsoft Office online help topic on the CITATION field code.

Alternatively, you can put your cursor inside any in-text citation, then go to 'References' tab in the ribbon and click 'Insert Citation'.

To change the separator between two grouped in-text citations, BibWord uses the separator element.

Only the name of the first author is displayed correctly, all other author names are abbreviated. Is this a bug?

No. You probably made a mistake when entering the different author names. You should enter them one by one in the dialog that comes up when clicking the "Edit..." button next to the author field. That way you will not make a mistake.

If you really want to enter them as a string, then be aware that the correct format is "Last1, First1 Middle1; Last2, First2 Middle2; ...". So the names are separated by a ";" while name parts are separated by a ",".

Note that there is a bug in Word where sometimes the name conversion goes wrong.

When using a numbered style (e.g. IEEE), the number is wrapped over multiple lines. Is this a bug?

No. Numbered styles are mostly represented using a 2 column table where the first column contains the number and the second column contains the text. The text wrap you see is caused by the first column not being wide enough. You can simple solve this by positioning your cursor on the the table border between the first and second column and drag it to the right.

This can also be used to add extra white space after the number if you set the halign element to left of the first column.

My in-text citations are displayed in bold. How do I change this?

If you link your in-text citation to your bibliography, Word formats the link using the 'Heading 2 Character style'. So if that style is configured to use bold, so will the in-text citation. Assuming you cannot or do not want to change that style, there are two possible solutions:

Disable linking between in-text citations and bibliographies.

This can be done easily be setting the value of citation_as_link to 'no' in the xsl file.

Format each in-text citation with another character style.

This way you will be able to keep using the links between in-text citations and bibliographies. To ease this job, you could use the following macro which you can run every time you insert an in-text citation or once at the end.

Sub ApplyCitationStyle()
    Dim stylename As String
    Dim exists As Boolean
    Dim s As Style
    Dim fld As Field
                
    stylename = "In-Text Citation"
        
    ' Check if the style already exists.
    exists = False
        
    For Each s In ActiveDocument.Styles
        If s.NameLocal = stylename Then
           exists = True
           Exit For
        End If
    Next
    
    ' If the style did not exist yet, create it.
    If exists = False Then
        Set s = ActiveDocument.Styles.Add(stylename, wdStyleTypeCharacter)
        s.BaseStyle = ActiveDocument.Styles(wdStyleDefaultParagraphFont).BaseStyle
        s.Font.Bold = False
    End If
    
    ' Now that the style really exists, select it.
    Set s = ActiveDocument.Styles(stylename)
     
    ' Apply the style to all in-text citations.
    For Each fld In ActiveDocument.Fields
        If fld.Type = wdFieldCitation Then
            fld.Select
            Selection.Style = s
        End If
    Next

End Sub